Git Product home page Git Product logo

chengfanbrain / fmriprep Goto Github PK

View Code? Open in Web Editor NEW

This project forked from nipreps/fmriprep

0.0 0.0 0.0 40.21 MB

fMRIPrep is a robust and easy-to-use pipeline for preprocessing of diverse fMRI data. The transparent workflow dispenses of manual intervention, thereby ensuring the reproducibility of the results.

Home Page: https://fmriprep.org

License: BSD 3-Clause "New" or "Revised" License

Python 12.67% Shell 0.04% HTML 86.60% Dockerfile 0.22% TeX 0.46% Makefile 0.01%

fmriprep's Introduction

fMRIPrep: A Robust Preprocessing Pipeline for fMRI Data

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.

Docker image available!

Available in CodeOcean!

image

Documentation Status

Latest Version

Published in Nature Methods

RRID:SCR_016216

About

image

fMRIPrep is a functional magnetic resonance imaging (fMRI) data preprocessing pipeline that is designed to provide an easily accessible, state-of-the-art interface that is robust to variations in scan acquisition protocols and that requires minimal user input, while providing easily interpretable and comprehensive error and output reporting. It performs basic processing steps (coregistration, normalization, unwarping, noise component extraction, segmentation, skullstripping etc.) providing outputs that can be easily submitted to a variety of group level analyses, including task-based or resting-state fMRI, graph theory measures, surface or volume-based statistics, etc.

Note

fMRIPrep performs minimal preprocessing. Here we define 'minimal preprocessing' as motion correction, field unwarping, normalization, bias field correction, and brain extraction. See the workflows section of our documentation for more details.

The fMRIPrep pipeline uses a combination of tools from well-known software packages, including FSL, ANTs, FreeSurfer and AFNI. This pipeline was designed to provide the best software implementation for each state of preprocessing, and will be updated as newer and better neuroimaging software become available.

This tool allows you to easily do the following:

  • Take fMRI data from raw to fully preprocessed form.
  • Implement tools from different software packages.
  • Achieve optimal data processing quality by using the best tools available.
  • Generate preprocessing quality reports, with which the user can easily identify outliers.
  • Receive verbose output concerning the stage of preprocessing for each subject, including meaningful errors.
  • Automate and parallelize processing steps, which provides a significant speed-up from typical linear, manual processing.

More information and documentation can be found at https://fmriprep.readthedocs.io/

Principles

fMRIPrep is built 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 dependence on the BIDS standard, manual parameter input is reduced to a minimum, allowing the pipeline 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 visual reports for each subject, detailing the accuracy of the most important 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.

Limitations and reasons not to use fMRIPrep

  1. Very narrow FoV (field-of-view) images oftentimes do not contain enough information for standard image registration methods to work correctly. Also, problems may arise when extracting the brain from these data. Supporting these particular images is already a future line of the development road-map.
  2. fMRIPrep may also underperform for particular populations (e.g., infants) and non-human brains, although appropriate templates can be provided to overcome the issue.
  3. The "EPInorm" approach is currently not supported, although we plan to implement this feature (see #620).
  4. If you really want unlimited flexibility (which is obviously a double-edged sword).
  5. If you want students to suffer through implementing each step for didactic purposes, or to learn shell-scripting or Python along the way.
  6. If you are trying to reproduce some in-house lab pipeline.

(Reasons 4-6 were kindly provided by S. Nastase in his open review of our pre-print).

Acknowledgements

Please acknowledge this work using the citation boilerplate that fMRIPrep includes in the visual report generated for every subject processed. For an illustration of how the citation boilerplate generally reads, please check our documentation.

fmriprep's People

Contributors

oesteban avatar effigies avatar chrisgorgo avatar rwblair avatar mgxd avatar jdkent avatar emdupre avatar tsalo avatar rciric avatar bpinsard avatar anibalsolon avatar romainvala avatar adelavega avatar markushs avatar kfinc avatar erramuzpe avatar craigmoodie avatar nirjacoby avatar danlurie avatar jsmentch avatar zhifangy avatar feilong avatar bbfrederick avatar utooley avatar yarikoptic avatar fliem avatar a3sha2 avatar kasbohm avatar soichih avatar wiheto avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.