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.

fetch_atlas_destrieux_2009

nilearn.datasets.fetch_atlas_destrieux_2009(lateralized=True, data_dir=None, url=None, resume=True, verbose=1)[source]

Download and load the Destrieux cortical deterministic atlas (dated 2009).

For more information, see the dataset description.

Note

Some labels from the list of labels might not be present in the atlas image, in which case the integer values in the image might not be consecutive.

Parameters:
lateralizedbool, default=True

If True, returns an atlas with distinct regions for right and left hemispheres.

data_dirpathlib.Path or str or None, 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 or None, 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.

verbosebool or int, default=1

Verbosity level (0 or False means no message).

Returns:
datasklearn.utils.Bunch

Dictionary-like object, contains:

  • atlas_type: str. Type of atlas. See Probabilistic atlas and Deterministic atlas.

  • labels: list of str. List of the names of the regions.

  • lut: pandas.DataFrame. Act as a look up table (lut) with at least columns ‘index’ and ‘name’. Formatted according to ‘dseg.tsv’ format from BIDS.

  • maps: str. Full path to 3D nifti file defining the cortical ROIs, lateralized or not. The image has shape (76, 93, 76), and contains integer values which can be interpreted as the indices in the list of labels.

  • template: str. The standardized space of analysis in which the data is provided.

See also

nilearn.datasets.fetch_atlas_surf_destrieux

Notes

If the dataset files are already present in the user’s Nilearn data directory, this fetcher will not re-download them. To force a fresh download, you can remove the existing dataset folder from your local Nilearn data directory.

For more details on how Nilearn stores datasets.

Examples using nilearn.datasets.fetch_atlas_destrieux_2009

Making a surface plot of a 3D statistical map

Making a surface plot of a 3D statistical map