fMRIprep is a functional magnetic resonance image pre-processing pipeline that
fMRIprep is a functional magnetic resonance imaging (fMRI) data pre-processing pipeline. It performs basic processing steps (coregistration, normalization, unwarping, noise component extraction, segmentation, skullstripping etc.) providing outputs that make running a variety of group level analyses (task based or resting state fMRI, graph theory measures, surface or volume, etc.) easy. fMRIrep is build around three principles:
- Robustness - the pipeline adapts the preprocessing steps depending on the input dataset and should provide results as good as possible independently of scanner make, scanning parameters or presence of additional correction scans (such as fieldmaps)
- Ease of use - thanks to dependance on the BIDS standard manual parameter input is reduced to a minimum allow the pipelien to run in an automatic fashion.
- “Glass box” philosophy - automation should not mean that one should not visually inspect the results or understand the methods. Thus fMRIprep provides for each subject visual reports detailing the accuracy of the most importatnt processing steps. This combined with the documentation can help researchers to understand the process and decide which subjects should be kept for the group level analysis.
These tools must be installed and their binaries available in the system’s $PATH.
The fMRIprep is packaged and available through the PyPi repository. Therefore, the easiest way to install the tool is:
pip install fmriprep
Execution and the BIDS format
The fmriprep workflow takes as principal input the path of the dataset that is to be processed. The only requirement to the input dataset is that it has a valid BIDS (Brain Imaging Data Structure) format. This can be easily checked online using the BIDS Validator.
The command line interface follows the BIDS-Apps definition. Example:
fmriprep data/bids_root/ out/ participant -w work/
Support and communication
The documentation of this project is found here: http://preprocessing-workflow.readthedocs.org/en/latest/.
If you have a problem or would like to ask a question about how to use fmriprep, please submit a question to NeuroStars.org with an fmriprep tag. NeuroStars.org is a platform similar to StackOverflow but dedicated to neuroinformatics.
All previous fmriprep questions are available here: http://neurostars.org/t/fmriprep/
To participate in the fmriprep development-related discussions please use the following mailing list: http://mail.python.org/mailman/listinfo/neuroimaging Please add [fmriprep] to the subject line when posting on the mailing list.
All bugs, concerns and enhancement requests for this software can be submitted here: https://github.com/poldracklab/preprocessing-workflow/issues.
Please acknowledge this work mentioning explicitly the name of this software (fmriprep) and the version, along with the link to the GitHub repository (https://github.com/poldracklab/preprocessing-workflow).
We use the 3-clause BSD license; the full license is in the file LICENSE in the fmriprep distribution.
All trademarks referenced herein are property of their respective holders.
Copyright (c) 2015-2016, the fmriprep developers and the CRN. All rights reserved.