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_mixed_gambles#

nilearn.datasets.fetch_mixed_gambles(n_subjects=1, data_dir=None, url=None, resume=True, return_raw_data=False, verbose=1)[source]#

Fetch Jimura “mixed gambles” dataset.

See Jimura and Poldrack[1].

Parameters:
n_subjectsint, default=1

The number of subjects to load. If None is given, all the subjects are used.

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

return_raw_databool, default=False

If False, then the data will transformed into an (X, y) pair, suitable for machine learning routines. X is a list of n_subjects * 48 Nifti1Image objects (where 48 is the number of trials), and y is an array of shape (n_subjects * 48,).

Returns:
dataBunch

Dictionary-like object, the attributes of interest are:

  • ‘zmaps’: list of str Paths to realigned gain betamaps (one nifti per subject).

  • ‘gain’: list of Nifti1Image or None If make_Xy is True, this is a list of n_subjects * 48 Nifti1Image objects, else it is None.

  • ‘y’: ndarray of shape (n_subjects * 48,) or None If make_Xy is True, then this is a ndarray of shape (n_subjects * 48,), else it is None.

  • ‘description’: data description

References