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.

8.2.21. nilearn.datasets.fetch_localizer_contrasts

nilearn.datasets.fetch_localizer_contrasts(contrasts, n_subjects=None, get_tmaps=False, get_masks=False, get_anats=False, data_dir=None, url=None, resume=True, verbose=1)

Download and load Brainomics/Localizer dataset (94 subjects).

“The Functional Localizer is a simple and fast acquisition procedure based on a 5-minute functional magnetic resonance imaging (fMRI) sequence that can be run as easily and as systematically as an anatomical scan. This protocol captures the cerebral bases of auditory and visual perception, motor actions, reading, language comprehension and mental calculation at an individual level. Individual functional maps are reliable and quite precise. The procedure is decribed in more detail on the Functional Localizer page.” (see http://brainomics.cea.fr/localizer/)

You may cite Papadopoulos Orfanos, Dimitri, et al. when using this dataset.

Scientific results obtained using this dataset are described in Pinel et al., 2007.

Parameters:

contrasts: list of str

The contrasts to be fetched (for all 94 subjects available). Allowed values are:

{"checkerboard",
"horizontal checkerboard",
"vertical checkerboard",
"horizontal vs vertical checkerboard",
"vertical vs horizontal checkerboard",
"sentence listening",
"sentence reading",
"sentence listening and reading",
"sentence reading vs checkerboard",
"calculation (auditory cue)",
"calculation (visual cue)",
"calculation (auditory and visual cue)",
"calculation (auditory cue) vs sentence listening",
"calculation (visual cue) vs sentence reading",
"calculation vs sentences",
"calculation (auditory cue) and sentence listening",
"calculation (visual cue) and sentence reading",
"calculation and sentence listening/reading",
"calculation (auditory cue) and sentence listening vs "
"calculation (visual cue) and sentence reading",
"calculation (visual cue) and sentence reading vs checkerboard",
"calculation and sentence listening/reading vs button press",
"left button press (auditory cue)",
"left button press (visual cue)",
"left button press",
"left vs right button press",
"right button press (auditory cue)",
"right button press (visual cue)",
"right button press",
"right vs left button press",
"button press (auditory cue) vs sentence listening",
"button press (visual cue) vs sentence reading",
"button press vs calculation and sentence listening/reading"}

or equivalently on can use the original names:

{"checkerboard",
"horizontal checkerboard",
"vertical checkerboard",
"horizontal vs vertical checkerboard",
"vertical vs horizontal checkerboard",
"auditory sentences",
"visual sentences",
"auditory&visual sentences",
"visual sentences vs checkerboard",
"auditory calculation",
"visual calculation",
"auditory&visual calculation",
"auditory calculation vs auditory sentences",
"visual calculation vs sentences",
"auditory&visual calculation vs sentences",
"auditory processing",
"visual processing",
"visual processing vs auditory processing",
"auditory processing vs visual processing",
"visual processing vs checkerboard",
"cognitive processing vs motor",
"left auditory click",
"left visual click",
"left auditory&visual click",
"left auditory & visual click vs right auditory&visual click",
"right auditory click",
"right visual click",
"right auditory&visual click",
"right auditory & visual click vs left auditory&visual click",
"auditory click vs auditory sentences",
"visual click vs visual sentences",
"auditory&visual motor vs cognitive processing"}

n_subjects: int or list, optional

The number or list of subjects to load. If None is given, all 94 subjects are used.

get_tmaps: boolean

Whether t maps should be fetched or not.

get_masks: boolean

Whether individual masks should be fetched or not.

get_anats: boolean

Whether individual structural images should be fetched or not.

data_dir: string, optional

Path of the data directory. Used to force data storage in a specified location.

url: string, optional

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

resume: bool

Whether to resume download of a partly-downloaded file.

verbose: int

Verbosity level (0 means no message).

Returns:

data: Bunch

Dictionary-like object, the interest attributes are :

  • ‘cmaps’: string list
    Paths to nifti contrast maps
  • ‘tmaps’ string list (if ‘get_tmaps’ set to True)
    Paths to nifti t maps
  • ‘masks’: string list
    Paths to nifti files corresponding to the subjects individual masks
  • ‘anats’: string
    Path to nifti files corresponding to the subjects structural images

See also

nilearn.datasets.fetch_localizer_calculation_task, nilearn.datasets.fetch_localizer_button_task

References

  • Papadopoulos Orfanos, Dimitri, et al. “The Brainomics/Localizer database.” NeuroImage 144.B (2017): 309.
  • Pinel, Philippe, et al. “Fast reproducible identification and large-scale databasing of individual functional cognitive networks.” BMC Neuroscience 8.1 (2007): 91.