Search bioRxiv⌕ Search

bioRxiv · 10.1101/2025.11.08.687330

QuNex Recipes: Executable, Human-Readable Workflows for Reproducible Neuroimaging Research

Abstract

Preprocessing and analysis of neuroimaging data are technically demanding, often requiring a combination of multiple software tools, modality-specific pipelines, and extensive parameter tuning to match dataset characteristics. These complexities make it difficult to document workflows in sufficient detail to ensure complete transparency and reproducibility. To address these challenges, we introduce QuNex recipes, a framework for defining and executing complete neuroimaging workflows - encompassing data onboarding, preprocessing, and analysis - in a transparent, machine- and human-readable format. Recipes are implemented as an integrated feature of the Quantitative Neuroimaging Environment & Toolbox (QuNex), a containerized, open-source platform for end-to-end multimodal and multi-species neuroimaging processing. The recipes framework enables seamless integration of QuNex commands with custom scripts and external tools, capturing every processing step and parameter setting. A fully reproducible study can thus be shared and replicated by providing only (a) the QuNex version used, (b) the recipe file, and (c) the data. This approach standardizes workflow specification, enhances transparency, and enables one-command replication of complex neuroimaging analyses. By providing a standardized way to describe and share workflows, recipes facilitate open exchange of best practices and reproducible methods within the neuroimaging community.

Source connections

Explore related subjects

Keep this discovery

Explore connections, maps & timelines

BibTeXRIS

Demsar, J., Kraljic, A., Matkovic, A., Brege, S., Pan, L., Tamayo, Z., Fonteneau, C., Helmer, M., Ji, J. L., Anticevic, A., Korponay, C., Salavrakos, M., Glasser, M. F., Nickerson, L. D., Cho, Y. T., Repovs, G.. 2025-11-10. QuNex Recipes: Executable, Human-Readable Workflows for Reproducible Neuroimaging Research. https://doi.org/10.1101/2025.11.08.687330

Cite the original work for its findings. Save a collection to share your selection of sources.

KEEP EXPLORING

Related preprints

The Unreasonable Effectiveness of Cell Types in Describing Neuronal Physiological Features

Single-cell RNA sequencing (scRNA-seq) captures detailed gene expression profiles at scale, while patch-clamp recordings measure intrinsic neuronal electrophysiological properties. Modeling the relations between these two modalities remains a challenge. Here, we compare how well electrophysiological features can be predicted by traditional transcriptomic cell type classification, representations derived from a foundational model (scGPT) pretrained on large-scale scRNA-seq datasets, ion channel-coding genes, and highly variable genes. Using paired transcriptomic and electrophysiological patch-sequencing data from 495 human neurons from neurosurgical tissue, we find that cluster-level cell type representations consistently outperform highly variable gene selection, ion channel gene selection, and context-enriched scGPT embeddings. Notably, performance varies across model architectures and initializations, and the best results are obtained by combining the outputs of separate cell type and scGPT-based models. Together, these findings suggest that traditional discrete cellular classification is highly effective in predicting physiological features. For maximum performance it can be complemented by pretrained transformer models.

neuroscience↗

A nonlinear inhibition pathway underlying cortical responses to tuned holographic optogenetic perturbations

Optogenetics enables causal manipulation of cortical activity. Perturbation responses can be counterintuitive due to network interactions, making theory essential for predicting them. Existing approaches often rely on linear approximations, which fail for many biologically relevant perturbations. Here we develop a nonlinear theory of responses to holographic perturbations in cell-type-specific recurrent networks with structured connectivity. We fit a nonlinear model to mouse V1 data, which shows cotuned-ensemble suppression: perturbing spatially clustered neurons with similar preferred orientations yields markedly stronger short-range suppression than perturbing untuned ensembles. We show that cotuned-ensemble suppression arises from a feature-tuned, nonlinear inhibition pathway implicating somatostatin-positive (SST) interneurons. The theory predicts that cotuned ensembles suppress parvalbumin-positive (PV) neurons but facilitate SST neurons, and links the degree of cotuned-ensemble suppression or facilitation to the variance of the SST response. This framework identifies mechanisms by which nonlinear inhibition sculpts cortical dynamics and establishes a predictive basis for targeted optogenetic interventions.

neuroscience↗

Proteomic signatures of APOE ε4 across human tissues and cell types in Alzheimers disease

The apolipoprotein E {varepsilon}4 (APOE {varepsilon}4) allele is the strongest genetic risk factor for late-onset Alzheimers disease (AD). However, the underlying molecular mechanisms remain unclear. This study included 1691 participants from the Religious Orders Study and Rush Memory and Aging Project (ROSMAP), 1226 participants from the Accelerating Medicines Partnership - Alzheimers Disease (AMP-AD) Diverse Cohorts Study, and 735 participants from the Alzheimers Disease Neuroimaging Initiative (ADNI). To characterise APOE {varepsilon}4 molecular effects, we analysed proteomic data from plasma, cerebrospinal fluid (CSF), and induced pluripotent stem cell (iPSC)-derived astrocytes and neurons, as well as transcriptomic and proteomic data from multiple brain regions. The association of APOE {varepsilon}4 with AD neuropathology was also examined. APOE {varepsilon}4 carriers shared a plasma proteomic signature enriched for immune processes, irrespective of AD diagnosis. A machine learning classifier trained on this signature discriminated APOE {varepsilon}4 carriers from non-carriers in an independent cohort using CSF proteomics. APOE {varepsilon}4 carriage was associated with higher Braak stages and Consortium to Establish a Registry for Alzheimers Disease (CERAD) score. However, only limited APOE {varepsilon}4-associated transcriptomic and proteomic changes were observed in bulk brain tissue, with poor cross-layer concordance. Proteomic analyses of iPSC-derived astrocytes and neurons further revealed cell-type-specific APOE {varepsilon}4-associated changes. APOE {varepsilon}4 is associated with a consistent proteomic signature across plasma and CSF. Its molecular effects in the brain differ across cell types, brain regions and molecular layers. These findings support the need for cell-type-resolved multi-omic studies to elucidate how APOE {varepsilon}4 confers AD risk.

neuroscience↗