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 | RSS feed

Download files

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

Source Distribution

fmriprep-0.1.2a0.tar.gz (893.9 kB view details)

Uploaded Source

File details

Details for the file fmriprep-0.1.2a0.tar.gz.

File metadata

  • Download URL: fmriprep-0.1.2a0.tar.gz
  • Upload date:
  • Size: 893.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for fmriprep-0.1.2a0.tar.gz
Algorithm Hash digest
SHA256 83dc16c0066b6b6817ee473fbdb43e7daf82c9f2566344cdb7dd7745ffd42b9a
MD5 398f9eec1ed899dd6da8526241b8a09d
BLAKE2b-256 fadb5c43fc026afa38662e930e3b3a0d67950a5af3f965f146c2a74d7bef40a9

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page