• Stars
    star
    617
  • Rank 72,271 (Top 2 %)
  • Language
    HTML
  • License
    Apache License 2.0
  • Created over 8 years ago
  • Updated about 1 month ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

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.

fMRIPrep: A Robust Preprocessing Pipeline for fMRI Data

fMRIPrep is a NiPreps (NeuroImaging PREProcessing toolS) application (www.nipreps.org) for the preprocessing of task-based and resting-state functional MRI (fMRI).

Docker image available! Available in CodeOcean! https://circleci.com/gh/nipreps/fmriprep/tree/master.svg?style=shield Documentation Status Latest Version Published in Nature Methods RRID:SCR_016216

About

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, skull-stripping, 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, and surface or volume-based statistics.

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 manual processing or shell-scripted pipelines.

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.

Citation

Citation boilerplate. Please acknowledge this work using the citation boilerplate that fMRIPrep includes in the visual report generated for every subject processed. For a more detailed description of the citation boilerplate and its relevance, please check out the NiPreps documentation.

Plagiarism disclaimer. The boilerplate text is public domain, distributed under the CC0 license, and we recommend fMRIPrep users to reproduce it verbatim in their works. Therefore, if reviewers and/or editors raise concerns because the text is flagged by automated plagiarism detection, please refer them to the NiPreps community and/or the note to this effect in the boilerplate documentation page.

Papers. fMRIPrep contributors have published two relevant papers: Esteban et al. (2019) [preprint], and Esteban et al. (2020) [preprint].

Other. Other materials that have been generated over time include the OHBM 2018 software demonstration and some conference posters:

  • Organization for Human Brain Mapping 2018 (Abstract; PDF)
_static/OHBM2018-poster_thumb.png
  • Organization for Human Brain Mapping 2017 (Abstract; PDF)
_static/OHBM2017-poster_thumb.png

License information

fMRIPrep adheres to the general licensing guidelines of the NiPreps framework.

License

Copyright (c) the NiPreps Developers.

As of the 21.0.x pre-release and release series, fMRIPrep is licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Acknowledgements

This work is steered and maintained by the NiPreps Community. This work was supported by the Laura and John Arnold Foundation, the NIH (grant NBIB R01EB020740, PI: Ghosh), and NIMH (R24MH114705, R24MH117179, R01MH121867, PI: Poldrack)

More Repositories

1

mriqc

Automated Quality Control and visual reports for Quality Assessment of structural (T1w, T2w) and functional MRI of the brain
Python
284
star
2

smriprep

Structural MRI PREProcessing (sMRIPrep) workflows for NIPreps (NeuroImaging PREProcessing tools)
Python
127
star
3

niworkflows

Common workflows for MRI (anatomical, functional, diffusion, etc)
Python
84
star
4

dmriprep

dMRIPrep is a robust and easy-to-use pipeline for preprocessing of diverse dMRI data. The transparent workflow dispenses of manual intervention, thereby ensuring the reproducibility of the results.
Python
63
star
5

sdcflows

Susceptibility Distortion Correction (SDC) workflows for EPI MR schemes
Python
30
star
6

nibabies

fMRIPrep-Infants - A robust, transparent workflow tailored for neonate and infant MRI
Python
20
star
7

fmriprep-notebooks

A repository for notebooks associated with FMRIPREP
Jupyter Notebook
16
star
8

eddymotion

Open-source eddy-current and head-motion correction for dMRI.
Python
13
star
9

fmriprep-rodents

fMRIPrep for Rodents
HTML
12
star
10

nirodents

Python
11
star
11

qc-book

ISMRM '22 QC Tutorial
Dockerfile
10
star
12

sops-cookiecutter

Template repo for bootstrapping and maintaining SOPs (Standard operation procedures)
Jinja
8
star
13

nipreps-book

Dockerfile
8
star
14

dmriprep-viewer

Interactive dmriprep report HTML, JS & CSS
Vue
8
star
15

nireports

The NiPreps' Reporting and Visualization system - report templates and "reportlets"
Python
7
star
16

nondefaced-detector

Identify non-defaced datasets before publication
Python
6
star
17

fmripost-aroma

Run ICA-AROMA on fMRIPrep derivatives
Python
6
star
18

mriqcwebapi

Python
5
star
19

fmriprep_stats

Automatic reports summarizing usage stats from Sentry.io
Jupyter Notebook
4
star
20

qkay

Manager for the quality assessment of large neuroimaging studies
HTML
4
star
21

mriqc-learn

Learning on MRIQC-generated image quality metrics (IQMs).
Python
4
star
22

mriqc-notebooks

A repository associated to MRIQC containing notebooks and other resources
Jupyter Notebook
4
star
23

migas-server

Python
3
star
24

TM-meetings

2
star
25

petqc

PETQC: image quality metrics for quality assessment of PET data
2
star
26

migas-py

A ready-to-go python package for communicating with a migas server
Python
2
star
27

petprep

PETPrep: A Robust Preprocessing Pipeline for PET Data
Python
2
star
28

version-schemes

setuptools_scm plugin for nipreps version schemes
Python
2
star
29

.github

Shared community health files
2
star
30

GOVERNANCE

The NiPreps Community's Governance Documents
Python
2
star
31

nipreps.github.io

The NiPreps landing page
Python
2
star
32

generalizable-brain-extraction

Generalizing antsBrainExtraction across populations and species
Python
1
star
33

freesurfer

Partial docker images for multi-staged builds
Dockerfile
1
star
34

mriqcwebapi-schemas

Schemas for the MRIQC WebAPI
Python
1
star
35

docker-images

Dockerfiles to build images for multi-stage builds
Dockerfile
1
star
36

fsl

Partial docker images for multi-staged builds
Dockerfile
1
star
37

fmripost-rapidtide

A BIDS App for running rapidtide on a preprocessed fMRI dataset.
Python
1
star
38

afni

Dockerfile
1
star
39

mriqc-report-hub

A web service to run QC on datasets with MRIQC individual reports
1
star
40

resampler

Single-shot resampling utility for nipreps derivatives
Python
1
star
41

synthstrip

Synthstrip integration to be used across nipreps
Python
1
star