Orchestrating neuroimaging data processing using the 'Snakemake' workflow manager.
Paper
Loaded from Europe PMC by your browser; OSCR does not store it: doi.org · Europe PMC
The paper is loaded when this pane is shown.
The authors' code
Shell · 43 lines · 982 B · MIT
- #!/bin/sh
- set -eu
- method="$1"
- script_name="$2"
- cp -r /app/* /work
- cp -r /snakebids /src
- script="'${script_name}' tests/data tests/result participant -c1 --skip-bids-validation"
- case "$method" in
- "setuptools" )
- python -m venv .venv
- .venv/bin/python -m pip install --no-color .
- PATH=".venv/bin:$PATH" eval "$script"
- ;;
- "poetry" )
- poetry install --no-ansi
- eval "poetry run $script"
- ;;
- "uv" )
- uv pip install --system .
- eval "uv run $script"
- ;;
- "hatch" )
- hatch env create
- eval "hatch env run -- $script"
- ;;
- "pdm" )
- pdm install
- eval "pdm run $script"
- ;;
- "docs" )
- python -m venv .venv
- .venv/bin/python -m pip install .
- .venv/bin/python -m pip install -r docs/requirements.txt
- .venv/bin/sphinx-build docs build/docs -W
- ;;
- * )
- >&2 echo "Invalid method"
- exit 1
- ;;
- esac
test-template.sh at commit 1d97fee, under MIT · at the source
Overview
- Melbourne Data Analytics Platform (MDAP), The University of Melbourne, Parkville, Australia
- Melbourne School of Psychological Sciences, The University of Melbourne, Parkville, Australia
- Graeme Clark Institute for Biomedical Engineering, The University of Melbourne, Parkville, Australia
Abstract
The processing of neuroimaging data typically involves a complicated set of operations, which often require different software packages and have intensive computational and storage demands. Although there are many options available for the neuroimaging researcher to establish their preferred set of processing operations, there is relatively little guidance on how to orchestrate such operations within a coherent data processing workflow. Here, by describing the construction of a simplified neuroimaging processing workflow, we demonstrate how the established general-purpose workflow manager ‘Snakemake’ can be used to facilitate neuroimaging data processing. Snakemake allows researchers to use a Python-based markup language to describe how input files are transformed into output files. Snakemake then uses these rules to schedule and execute the computational jobs that are required to generate the output files, without unnecessary recreation of existing output files. This allows the complete processing workflow to be executed with a single command and creates workflows that are interpretable, efficient, and reproducible.
Reproduced under the paper's license (CC BY), from the paper cited above.
Repositories
Its files are read in the Code ↔ Paper reader above.
unimelbmdap/neuroimaging_containers
99380e076a3d62ce7025f8770f2cf9d7880f114e, 12 February 2026Availability: 1 check, the latest on 26 September 2026: the link answers
- 26 September 2026: the link answers
1 file
- README.md, Text, 33 lines
khanlab/snakebids
1d97feeb39fde9e47b4a403c8f277bd0e8781eef, 13 March 2026Availability: 1 check, the latest on 26 September 2026: the link answers
- 26 September 2026: the link answers
96 files
- containers/
test-template/ , Shell, 43 linestest-template.sh - docs/
conf.py , Python, 125 lines - docs/
tutorial/ , Python, 13 linesstep8/ run.py - scripts/
__init__.py , Python, 2 lines - scripts/
update_bids.py , Python, 158 lines - src/
snakebids/ , Python, 35 lines__init__.py - src/
snakebids/ , Python, 47 lines_warningformat.py - src/
snakebids/ , Python, 136 linesadmin.py - src/
snakebids/ , Python, 158 linesapp.py - src/
snakebids/ , Python, 10 linesbidsapp/ __init__.py - src/
snakebids/ , Python, 22 linesbidsapp/ args.py - src/
snakebids/ , Python, 4 linesbidsapp/ hook.py - src/
snakebids/ , Python, 109 linesbidsapp/ hookspecs.py - src/
snakebids/ , Python, 188 linesbidsapp/ run.py - src/
snakebids/ , Python, 27 linescli.py - src/
snakebids/ , Python, 24 linescore/ __init__.py - src/
snakebids/ , Python, 388 linescore/ _querying.py - src/
snakebids/ , Python, 1,003 linescore/ datasets.py - src/
snakebids/ , Python, 286 linescore/ filtering.py - src/
snakebids/ , Python, 803 linescore/ input_generation.py - src/
snakebids/ , Python, 39 linesexceptions.py - src/
snakebids/ , Python, 10 linesio/ __init__.py - src/
snakebids/ , Python, 43 linesio/ config.py - src/
snakebids/ , Python, 123 linesio/ console.py - src/
snakebids/ , Python, 133 linesio/ printing.py - src/
snakebids/ , Python, 33 linesio/ yaml.py - src/
snakebids/ , Python, 10 linesjinja2_ext/ __init__.py - src/
snakebids/ , Python, 13 linesjinja2_ext/ colorama.py - src/
snakebids/ , Python, 27 linesjinja2_ext/ format_dep_spec.py - src/
snakebids/ , Python, 32 linesjinja2_ext/ snakebids_version.py - src/
snakebids/ , Python, 30 linesjinja2_ext/ toml_encode.py - src/
snakebids/ , Python, 90 linesjinja2_ext/ vcs.py - src/
snakebids/ , Python, 20 linespaths/ __init__.py - src/
snakebids/ , Python, 62 linespaths/ _config.py - src/
snakebids/ , Python, 374 linespaths/ _factory.py - src/
snakebids/ , Python, 172 linespaths/ _presets.py - src/
snakebids/ , Python, 10 linespaths/ _templates/ __init__.py - src/
snakebids/ , Python, 106 linespaths/ _templates/ spec_func.py - src/
snakebids/ , Python, 119 linespaths/ _utils.py - src/
snakebids/ , Python, 9 linespaths/ resources/ __init__.py - src/
snakebids/ , Python, 64 linespaths/ specs.py - src/
snakebids/ , Python, 30 linesplugins/ __init__.py - src/
snakebids/ , Python, 118 linesplugins/ base.py - src/
snakebids/ , Python, 212 linesplugins/ bidsargs.py - src/
snakebids/ , Python, 128 linesplugins/ cli_config.py - src/
snakebids/ , Python, 257 linesplugins/ component_edit.py - src/
snakebids/ , Python, 122 linesplugins/ pybidsdb.py - src/
snakebids/ , Python, 339 linesplugins/ snakemake.py - src/
snakebids/ , Python, 108 linesplugins/ validator.py - src/
snakebids/ , Python, 57 linesplugins/ version.py - src/
snakebids/ , Python, 1 lineproject_template/ {{name_slug}}/ __init__.py - src/
snakebids/ , Python, 7 linesresources/ __init__.py - src/
snakebids/ , Python, 32 linessnakemake_compat.py - src/
snakebids/ , Python, 148 linestypes.py - src/
snakebids/ , Python, 10 linesutils/ __init__.py - src/
snakebids/ , Python, 231 linesutils/ containers.py - src/
snakebids/ , Python, 134 linesutils/ output.py - src/
snakebids/ , Python, 20 linesutils/ sb_itertools.py - src/
snakebids/ , Python, 156 linesutils/ snakemake_io.py - src/
snakebids/ , Python, 418 linesutils/ snakemake_templates.py - src/
snakebids/ , Python, 2 linesutils/ user_property.py - src/
snakebids/ , Python, 338 linesutils/ utils.py - tests/
__init__.py , Python, 7 lines - tests/
conftest.py , Python, 79 lines - tests/
helpers.py , Python, 359 lines - tests/
strategies.py , Python, 693 lines - tests/
test_admin.py , Python, 184 lines - tests/
test_app.py , Python, 135 lines - tests/
test_bidsapp.py , Python, 223 lines - tests/
test_datasets.py , Python, 1,008 lines - tests/
test_filtering.py , Python, 92 lines - tests/
test_generate_inputs.py , Python, 1,722 lines - tests/
test_output.py , Python, 107 lines - tests/
test_paths/ , Python, 7 lines__init__.py - tests/
test_paths/ , Python, 481 linestest_bids.py - tests/
test_paths/ , Python, 145 linestest_specs.py - tests/
test_plugins/ , Python, 6 lines__init__.py - tests/
test_plugins/ , Python, 98 linestest_bidsargs.py - tests/
test_plugins/ , Python, 128 linestest_cli_config.py - tests/
test_plugins/ , Python, 411 linestest_component_edit.py - tests/
test_plugins/ , Python, 136 linestest_pybidsdb.py - tests/
test_plugins/ , Python, 502 linestest_snakemake.py - tests/
test_plugins/ , Python, 81 linestest_validate_plugin.py - tests/
test_plugins/ , Python, 60 linestest_version.py - tests/
test_printing.py , Python, 224 lines - tests/
test_querying.py , Python, 580 lines - tests/
test_snakemake_io.py , Python, 35 lines - tests/
test_snakemake_templates , Python, 6 lines/ __init__.py - tests/
test_snakemake_templates , Python, 47 lines/ strategies.py - tests/
test_snakemake_templates , Python, 807 lines/ test_snakemake_formatter .py - tests/
test_snakemake_templates , Python, 411 lines/ test_snakemake_wildcards .py - tests/
test_template.py , Python, 381 lines - tests/
test_utils.py , Python, 347 lines - tests/
test_yaml.py , Python, 101 lines - LICENSE, License, 21 lines
- README.md, Text, 109 lines
The paper's code and data availability statement is in the Data section.
Tracing map
Proposed by the machine: these links were found in the paper and verified at the source, without human review. The map will receive a Zenodo DOI once one of the paper's authors has validated it with their ORCID.
What the map holds:
- 2 repositories of the authors' code, each at its verified commit, with its license and how the link was found in the paper;
- 94 scripts, each with its path and the digest of its content;
- no match between paragraphs and code yet;
- neither the text of the paper nor the code itself.
Its JSON (tracing-map.json) is deposited on Zenodo with its DOI once the map is validated.
Data
Datasets cited
- github.com/
unimelbmdap/ , at github.com; found in “Data availability”snakemake_paper_demo_wor kflow_data - unimelbmdap.github.io/
neuroimaging_snakemake_t , at unimelbmdap.github.io; found in the text, “Footnotes”utorial
Data availability
The example workflow is available at https://
Reproduced under the paper's license (CC BY), from the paper cited above.
Versions
The history of this record: each version stored by the harvester or made by a correction of its authors or of the maintainers of its code, and what changed in its facts. The texts of the paper (its abstract, its availability statements) are not part of it; versions that changed only those are not listed.
Version 3, 28 September 2026
- Publisher: n/a → Springer Science+Business Media
Version 1, 27 September 2026: the first record
Recorded: type, language, journal, volume, issue, pages, dates, 4 authors, 5 keywords, 5 MeSH terms, 1 funder, 21 references.
Cite
This paper
Mannion, D. J., Quiroga, M. d. M., Paul, J. M., & Garrido, M. I. (2026). Orchestrating neuroimaging data processing using the 'Snakemake' workflow manager. Brain structure & function, 231(8), 131. https://
BibTeX
@article{mannion2026orch
author = {Mannion, Damien J and Quiroga, Maria del Mar and Paul, Jacob M and Garrido, Marta I},
title = {{Orchestrating neuroimaging data processing using the 'Snakemake' workflow manager}},
journal = {Brain structure \& function},
year = {2026},
month = sep,
volume = {231},
number = {8},
pages = {131},
publisher = {Springer Science+Business Media},
issn = {1863-2653},
doi = {10.1007/
url = {https://
pmid = {42696207},
pmcid = {PMC13545037}
}
RIS
TY - JOUR
AU - Mannion, Damien J
AU - Quiroga, Maria del Mar
AU - Paul, Jacob M
AU - Garrido, Marta I
TI - Orchestrating neuroimaging data processing using the 'Snakemake' workflow manager
T2 - Brain structure & function
J2 - Brain Struct Funct
PY - 2026
DA - 2026/
VL - 231
IS - 8
SP - 131
SN - 1863-2653
PB - Springer Science+Business Media
DO - 10.1007/
UR - https://
LA - en
ER -
CSL-JSON
{
"id": "10.1007/
"type": "article-journal",
"title": "Orchestrating neuroimaging data processing using the 'Snakemake' workflow manager",
"container-title": "Brain structure & function",
"author": [
{
"family": "Mannion",
"given": "Damien J"
},
{
"family": "Quiroga",
"given": "Maria del Mar"
},
{
"family": "Paul",
"given": "Jacob M"
},
{
"family": "Garrido",
"given": "Marta I"
}
],
"container-title-short":
"volume": "231",
"issue": "8",
"page": "131",
"DOI": "10.1007/
"PMID": "42696207",
"PMCID": "PMC13545037",
"ISSN": "1863-2653",
"publisher": "Springer Science+Business Media",
"URL": "https://
"language": "en",
"issued": {
"date-parts": [
[
2026,
9,
4
]
]
}
}
The tracing map gets a citation of its own once an author has validated it and it has a DOI.
Similar papers
The papers with a page that share the most with this one: the tools found in their code, their categories, datasets, cited references and authors, the rarest counting most.
- [1] doi:10.1093/scan/nsag053
- Safety-relevant experience reshapes neural codes for ambiguous threat in adolescents.Journal: Social cognitive and affective neuroscienceIn common: 1 reference, 2 authors
- [2] doi:10.1016/j.neuroimage.2022.119623 [code]
- Open and reproducible neuroimaging: From study inception to publication.Journal: NeuroImageIn common: BIDS Validator, PyBIDS, 5 references
- [3] doi:10.7554/elife.79277 [code]
- Neuroscout, a unified platform for generalizable and reproducible fMRI research.Journal: eLifeIn common: BIDS Validator, PyBIDS, methods / tools, 3 references
- [4] doi:10.1093/schizbullopen/sgae010 [code]
- Cortical Network Disruption Is Minimal in Early Stages of Psychosis.Journal: Schizophrenia bulletin openIn common: BIDS Validator, Snakemake, PyBIDS, 1 reference
- [5] doi:10.1162/imag.a.79 [code]
- Open-source platforms to investigate analytical flexibility in neuroimaging.Journal: Imaging neuroscience (Cambridge, Mass.)In common: PyBIDS, methods / tools, 5 references
- [6] doi:10.1002/hbm.25829 [code]
- ENIGMA HALFpipe: Interactive, reproducible, and efficient analysis for resting-state and task-based fMRI data.Journal: Human brain mappingIn common: PyBIDS, methods / tools, 5 references
- [7] doi:10.1162/netn_a_00322 [code]
- A pattern of cognitive resource disruptions in childhood psychopathology.Journal: Network neuroscience (Cambridge, Mass.)In common: BIDS Validator, PyBIDS, 3 references
- [8] doi:10.1038/s41467-024-50826-8 [code]
- A standardized image processing and data quality platform for rodent fMRI.Journal: Nature communicationsIn common: PyBIDS, methods / tools, 5 references
- [9] doi:10.1162/imag.a.1274 [code]
- QuNex recipes: Executable, human-readable workflows for reproducible neuroimaging research.Journal: Imaging neuroscience (Cambridge, Mass.)In common: methods / tools, 6 references
- [10] doi:10.7554/elife.71774 [code]
- The OpenNeuro resource for sharing of neuroscience data.Journal: eLifeIn common: PyBIDS, methods / tools, 4 references
Contribute
The authors of this paper can claim it, correct its record and validate its tracing map, and the maintainers of its code (its owner, or a public member of its organization) correct what it says of their repository; anyone signed in can ask for its removal. Every request goes to OSCR's own machine, which answers it; your account page follows them.
Sign in with ORCID to claim this paper as one of its authors, correct its record or validate its tracing map: when the paper's metadata lists your ORCID iD, you are recognized at once. Maintainers of its code: sign in with GitHub, then claim the repository on your account page.
Claim this paper
Correct its record
Say what each link of this record is, remove the ones that are not the paper's, add the ones that are missing. The correction becomes a new version of the record, in its Versions section.
Validate its tracing map
You validate the map as this page shows it: 2 repositories of the authors' code, each at its verified commit and with its license, 94 scripts, and 0 matches between paragraphs and code (see the Code and Map sections). It then receives a DOI on Zenodo, with you (your ORCID iD) and OSCR as its creators; the code itself is not deposited.
The map's fingerprint: sha256:52519dc5d932523c…
Add the badge to the code's README
If you are an author or a maintainer of this paper's code, you can add this badge. It says what OSCR knows of the paper (its code, its validated tracing map) and links the code to this page. Paste one of these snippets under the README's title. Keep the two marks around it, so that the badge can be replaced in place and is never added twice. OSCR changes nothing in your repository.
Markdown
<!-- oscr-badge:start -->
[](https://openscicode.org/badge/doi/10.1007/s00429-026-03189-3)
<!-- oscr-badge:end -->reStructuredText
.. oscr-badge:start
.. image:: https://openscicode.org/badge/doi/10.1007/s00429-026-03189-3.svg
:target: https://openscicode.org/badge/doi/10.1007/s00429-026-03189-3
:alt: OSCR
.. oscr-badge:endHTML
<!-- oscr-badge:start -->
<a href="https://openscicode.org/badge/doi/10.1007/s00429-026-03189-3"><img src="https://openscicode.org/badge/doi/10.1007/s00429-026-03189-3.svg" alt="OSCR"></a>
<!-- oscr-badge:end -->On GitHub, open the README, choose Edit (the pencil), paste the snippet under the title, then "Commit changes".
If you choose to, you can have the badge kept up to date for you, with oscr badge --write from the command line or with the GitHub Action in your repository's workflows. Every other form and option (a card, AsciiDoc, LaTeX, shields.io) is on the badge page.
Request its removal
To ask OSCR to remove this record, the copies of its authors' scripts or its tracing map, use the removal request page: signed in, you say who you are, what to remove and why, then review and confirm the request. Published rules decide every request (how).
Discussion, reproductions, activity
Discussion: code errors and mismatches between the code and the paper about this paper and its code, from readers and its authors, beside the paper and its tracing map.
Report a mismatch between the code and the paper · Report a code error (signed in)
Reproductions: reports from readers who ran the authors' code and did not get the paper's result, what they ran, with which environment, commit and data.
Report a reproduction failure (signed in)
Versions of its code: the releases of its code tied to a version of this paper (the preprint, the accepted manuscript, the version of record…), each with the tracing map versioned with it.
Activity: what happens around this paper: new versions of its record, its map's validation, discussions and reproductions. It opens with sign-in.
