Skip to content

Benchmark denoising strategies available from fmriprep.

License

Notifications You must be signed in to change notification settings

SIMEXP/fmriprep-denoise-benchmark

Repository files navigation

Benchmark denoising strategies on fMRIPrep output

DOI

The project is a continuation of load_confounds. The aim is to evaluate the impact of denoising strategy on functional connectivity data, using output processed by fMRIPrep LTS in a reproducible workflow.

Preprint of the manuscript is now on biorxiv. The reporducible Jupyter Book preprint is on NeuroLibre.

Recommandations for those who thought this project is a software

Bad news, this is not a software but a research project. It's more similar to your regular data science project. In other words, the code in this repository reflects the research done for the manuscript, and is not suitable for production level application.

Some useful part of the code has been extracted and further reviewed within SIMEXP lab for deplyment on generic fmriprep derivatives as docker images.

Quick start

git clone --recurse-submodules https://github.com/SIMEXP/fmriprep-denoise-benchmark.git
cd fmriprep-denoise-benchmark
virtualenv env
source env/bin/activate
pip install -r binder/requirements.txt
pip install .
make data
make book

Dataset structure

  • binder/ contains files to configure for neurolibre and/or binder hub.

  • content/ is the source of the JupyterBook.

  • data/ is reserved to store data for running analysis. To build the book, one will need all the metrics from the study. The metrics are here: DOI The data will be automatically downloaded to content/notebooks/data. You can by pass this step through accessing the Neurolibre preprint DOI!

  • Custom code is located in fmriprep_denoise/. This project is installable.

  • Preprocessing SLURM scripts, and scripts for creating figure for manuscript are in scripts/.