Wrapping FreeSurfer 6 for use in high-performance computing environments

Dataset type: Imaging, Neuroscience
Data released on October 27, 2016

Johnson HJ (2016): Wrapping FreeSurfer 6 for use in high-performance computing environments GigaScience Database. http://dx.doi.org/10.5524/100230


The purpose of this project is to wrap the recon-all workflow from FreeSurfer 6.0 beta in a Python processing framework for neuroimaging data called Nipype. FreesSurfer, an image analysis suite, performs cortical reconstruction and volumetric segmentation. FreeSurfer’s recon-all workflow provides researchers a simple interface for automatically processing of MRI data. Currently recon-all makes command-line program calls to other FreeSurfer processes from a tcsh script. Nipype offers a framework in python for making command-line program calls that will allow for faster processing in a high-performance computing environment. This will allow high-performance computing environments to execute steps of the workflow that are independent of each other to be run in parallel. The wrapping of the workflow in Nipype will also allow for easier manipulation of the individual steps in the workflow.
FreeSurfer’s recon-all tcsh workflow was used to process a set of MRI images. Recon-all then output a list of commands used to process the MRI data. The output commands were placed in a Nipype workflow. If a command did not have a pre-existing Nipype interface, then one was created. In order to ensure that the two workflows were analogous the Nipype and the tcsh workflow were run on the same set of MRI images and the outputs were compared. The comparisons were carried out with SimpleITK for image files and VTK for surface files.
All output images and surfaces from FreeSurfer’s recon-all were identical to those of the Nipype workflow. The stats files were also shown to be equivalent. Less significant files, such as log files, were either not thoroughly compared or were not output by the Nipype workflow.
The created Nipype workflow was shown to be analogous to pre-existing FreeSurfer tcsh workflow. With further development, Nipype could serve as a complete replacement to the tcsh workflow. This would allow for easier development of the workflow by researchers. Thorough testing on the processing times of the workflows in a high performance environment has not yet been evaluated, but it is hypothesized that the Nipype workflow will perform much faster. The collaborations at the 2015 OHBM BrainHack meeting were instrumental in accomplishing this task. Collaborations with the FreeSurfer, Nipype, and Human Connectome teams allowed members of this project to quickly identify problems and avoid unnecessary failures.

Additional details

Read the peer-reviewed publication(s):

Related datasets:

doi:10.5524/100230 IsPartOf doi:10.5524/100215

Additional information:


Displaying 1-1 of 1 File(s).
Date Action
October 27, 2016 Dataset publish
November 17, 2016 Manuscript Link added : 10.1186/s13742-016-0147-0