Skip to main content

fMRIprep is a functional magnetic resonance image pre-processing pipeline that

Project description

This pipeline is developed by the Poldrack lab at Stanford University for use at the Center for Reproducible Neuroscience (CRN), as well as for open-source software distribution.

https://circleci.com/gh/poldracklab/fmriprep/tree/master.svg?style=shield Documentation Status Latest Version

About

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:

  1. 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)
  2. 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.
  3. “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.

External Dependencies

fMRIprep is implemented using nipype, but it requires some other neuroimaging software tools: FSL, ANTs, AFNI, FreeSurfer, C3D.

These tools must be installed and their binaries available in the system’s $PATH.

Installation

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.

Acknowledgements

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

License information

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.

Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
fmriprep-0.1.2a2.tar.gz (893.9 kB) Copy SHA256 hash SHA256 Source None Oct 4, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page