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_surf_fsaverage

nilearn.datasets.fetch_surf_fsaverage(mesh='fsaverage5', data_dir=None)[source]

Download a Freesurfer fsaverage surface.

File names are subject to change and only attribute names are guaranteed to be stable across nilearn versions. See Fischl et al.[1].

See load_fsaverage and load_fsaverage_data to access fsaverage data as SurfaceImage.

Changed in Nilearn 0.14.0dev: The data for fsaverage3 and fsaverage4 have been updated to have their vertices in the same order as fsaverage5-7. Old faulty local copies of fsaverage3 and fsaverage4 are corrected the first time they are loaded.

Parameters:
meshstr, default=’fsaverage5’

Which mesh to fetch. Should be one of the following values:

  • "fsaverage3": the low-resolution fsaverage3 mesh (642 nodes)

  • "fsaverage4": the low-resolution fsaverage4 mesh (2562 nodes)

  • "fsaverage5": the low-resolution fsaverage5 mesh (10242 nodes)

  • "fsaverage6": the medium-resolution fsaverage6 mesh (40962 nodes)

  • "fsaverage7": same as “fsaverage”

  • "fsaverage": the high-resolution fsaverage mesh (163842 nodes)

Note

The high-resolution fsaverage will result in more computation time and memory usage

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.

Returns:
datasklearn.utils.Bunch

Dictionary-like object, where each value is a path to a Gifti file and the keys are:

  • ‘flat_left’: left hemisphere flat surface mesh

  • ‘flat_right’: right hemisphere flat surface mesh

  • ‘infl_left’: left hemisphere inflated pial surface mesh

  • ‘infl_right’: right hemisphere inflated pial surface mesh

  • ‘pial_left’: left hemisphere pial surface mesh

  • ‘pial_right’: right hemisphere pial surface mesh

  • ‘sphere_left’: left hemisphere sphere surface mesh

  • ‘sphere_right’: right hemisphere sphere surface mesh

  • ‘white_left’: left hemisphere white surface mesh

  • ‘white_right’: right hemisphere white surface mesh

  • ‘area_left’: left hemisphere area data

  • ‘area_right’: right hemisphere area data

  • ‘curv_left’: left hemisphere curvature data

  • ‘curv_right’: right hemisphere curvature data

  • ‘sulc_left’: left hemisphere sulcal depth data

  • ‘sulc_right’: right hemisphere sulcal depth data

  • ‘thick_left’: left hemisphere cortical thickness data

  • ‘thick_right’: right hemisphere cortical thickness data

References