Package freesurferformats details

Read and Write 'FreeSurfer' Neuroimaging File Formats

Provides functions to read and write neuroimaging data in various file formats, with a focus on 'FreeSurfer' formats. This includes, but is not limited to, the following file formats: 1) MGH/MGZ format files, which can contain multi-dimensional images or other data. Typically they contain time-series of three-dimensional brain scans acquired by magnetic resonance imaging (MRI). They can also contain vertex-wise measures of surface morphometry data. The MGH format is named after the Massachusetts General Hospital, and the MGZ format is a compressed version of the same format. 2) 'FreeSurfer' morphometry data files in binary 'curv' format. These contain vertex-wise surface measures, i.e., one scalar value for each vertex of a brain surface mesh. These are typically values like the cortical thickness or brain surface area at each vertex. 3) Annotation file format. This contains a brain surface parcellation derived from a cortical atlas. 4) Surface file format. Contains a brain surface mesh, given by a list of vertices and a list of faces.

Maintainer: Tim Sch < ts+code at >

From within R, enter citation('freesurferformats')

To cite package 'freesurferformats' in publications use:

Tim Sch?fer (NA). freesurferformats: Read and Write 'FreeSurfer'
Neuroimaging File Formats. R package version 0.1.13.

A BibTeX entry for LaTeX users is

title = {freesurferformats: Read and Write 'FreeSurfer' Neuroimaging File Formats},
author = {Tim Sch?fer},
note = {R package version 0.1.13},
url = {},


If you have any problems with this package you can open a new issue or check the already existing ones here.

To install this package, start R and enter:


# Default Install

# from GitHub
neuro_install('freesurferformats', release = "stable", release_repo = "github")
neuro_install('freesurferformats', release = "current", release_repo = "github")

More detailed installation instructions can be found here.


Initially submitted on September 11 2020 8:35AM
Last updated on October 15 2020 2:50PM
Package type standard
Source GitHub GitHub
Neuroconductor GitHub GitHub