OSCR

Experimental quality control induces changes in Allen mouse brain connectomes.

Code ↔ Paper

15 matches between paragraphs of the paper and lines of its authors' code, computed by the harvester (lexical-v1). Click a colored paragraph or line to see its counterpart.

The 15 matches · 3 of them tie a paragraph to a whole file, not to given lines: weak matches, whose lines are not tinted
  1. [1] § Methods › Defining injection density and projection density ↔ before_manual_qc/download_knox_conn_data.sh, the whole file · a weak match · score 0.79 · injection fraction, WT experiments, injection density, Allen API, projection density, downloaded
  2. [2] § Methods › Defining injection density and projection density ↔ before_manual_qc/multiply_threshold_inj_proj.sh, the whole file · a weak match · score 0.77 · injection fraction, WT experiments, injection density, Allen API, projection density, tracer
  3. [3] § Methods › Nested leave-one-out cross-validation analysis ↔ run-all-after-manual-QC.sh, lines 46–123 · score 0.70 · nested homogeneous, nested voxel, compile, connectivity models, sensitivity, py
  4. [4] § Methods › Automated quality control ↔ before_manual_qc/create_automated_qc_csv.R, lines 48–94 · score 0.67 · cerebral aqueduct, injection density, thin, misalignment, ventricular, manual QC
  5. [5] § Methods › Manual quality control ↔ before_manual_qc/make_qc_images_bin_threshold.sh, lines 41–122 · score 0.64 · QC images, slice images, projection densities, sh, cropping, manual QC
  6. [6] § Methods › Defining injection density and projection density ↔ before_manual_qc/multiply_threshold_inj_proj.sh, the whole file · a weak match · score 0.61 · injection fraction, injection density, projection density, segmented, connectomes
  7. [7] § Methods › Automated quality control ↔ after_manual_qc/overall_qc_exclusion.R, lines 1–43 · score 0.61 · robust outlier filtering, ventricular voxels, skewness, threshold, injection
  8. [8] § Methods › Rebuilding the regionalized voxel and homogeneous model connectomes ↔ after_manual_qc/build_model_new_excluded.py, lines 47–151 · score 0.59 · build model, normalized connection strengths, hyperparameter, weights, fitted, rebuilt
  9. [9] § Methods › Rebuilding the regionalized voxel and homogeneous model connectomes ↔ run-all-after-manual-QC.sh, lines 1–44 · score 0.58 · mouse_connectivity_models, Allen API, Knox connectome, rebuild, rebuilt, QC
  10. [10] § Methods › Nested leave-one-out cross-validation analysis ↔ after_manual_qc/run_nested_homogeneous_new_excluded.py, lines 35–48 · score 0.57 · nested homogeneous, cross validation, error, models, QC
  11. [11] § Methods › Rich club and community detection analysis ↔ graph_theory/rich_club_connectome_bin.m, lines 1–5 · score 0.57 · Brain Connectivity Toolbox, Rich Club, MATLAB
  12. [12] § Methods › Rebuilding the regionalized voxel and homogeneous model connectomes ↔ run-all-after-manual-QC.sh, lines 46–123 · score 0.51 · hyperparameter selection, py, homogeneous, Rebuilding, rebuilt, model
  13. [13] § Results › Manual QC reveals spatially and qualitatively diverse failures ↔ after_manual_qc/overall_qc_exclusion.R, lines 181–257 · score 0.51 · cortical leaking, Manual QC, nonspecific, misaligned, removal, injections
  14. [14] § Methods › Nested leave-one-out cross-validation analysis ↔ after_manual_qc/run_hyperparameter_selection_new_excluded.py, lines 35–56 · score 0.51 · voxel model, optimal, hyperparameter, fitted, kernel, Nested
  15. [15] § Methods › Rich club and community detection analysis ↔ visualizations/figure_5.R, lines 297–353 · score 0.51 · Louvain community assignments, rich club, connections

Paper

Loaded from Europe PMC by your browser, not stored by OSCR: doi.org · Europe PMC

The paper is loaded when this pane is shown.

The authors' code

Shell · 123 lines · 5.5 KB · no license · 3 matches

  1. #!/bin/bash
  2. source load-all-modules.sh
  3. set -euo pipefail
  4. ##################################################################################################
  5. cd after_manual_qc
  6. #### NOTE: All scripts here run with injection thresholds of 0.5 and projection thresholds of 0.1###
  7. #####THIS STEP REQUIRES RATINGS. Can skip and using ratings from Nathan et al., 2026, which are in harmonized_ratings
  8. #../derivatives/knox_inj/bin0.5/; ../derivatives/knox_proj/bin0.5/;
  9. #./derivatives/knox_proj/bin0.5/allen_api_not_in_knox; ../derivatives/knox_proj/bin0.5/allen_api_not_in_knox
  10. #Rscript compare_manual_qc_both_raters.R
  11. ###############START HERE########################################
  12. #################################################################
  13. #####run with different binarization thresholds (for automated QC)##
  14. Rscript overall_qc_exclusion.R 0.4 0.05
  15. Rscript overall_qc_exclusion.R 0.5 0.1
  16. Rscript overall_qc_exclusion.R 0.6 0.2
  17. ##################################################################################################
  18. ###very slight modifications needed to mouse_connectivity_models to get things running (legacy python)
  19. ###single change to line 5 of scorers.py
  20. cp scorers_updated.py ../mouse_connectivity_models/paper/figures/model_comparison/helpers/scorers.py
  21. ./patch_api_timeout.sh ###increase time limits for file loads to allow download of all conn. files
  22. oh_rgn_list="../../preprocessed/allen_template_inputs/oh_connectome_rgn_numbers_ccfv3.txt"
  23. knox_region_list="../../preprocessed/allen_template_inputs/knox_connectome_rgn_numbers_ccfv3.txt"
  24. ###rebuild connectomes with the original list of experiments to exclude from Knox et al., 2018
  25. source ../.venv/bin/activate
  26. ./rebuild_oh_connectome.sh "experiments_exclude.json" ${oh_rgn_list} "original"
  27. ./rebuild_oh_connectome.sh "experiments_exclude.json" ${knox_region_list} "original_291"
  28. ./rebuild_knox_connectome.sh "experiments_exclude.json" "original"
  29. ./rebuild_knox_connectome.sh "experiments_exclude.json" "original_oh_211_regions"
  30. ###rebuild connectomes with increased list of experiments to exclude post-QC
  31. ./rebuild_oh_connectome.sh "experiments_exclude_updated.json" ${oh_rgn_list} "rebuilt"
  32. ./rebuild_oh_connectome.sh "experiments_exclude_updated.json" ${knox_region_list} "rebuilt_291"
  33. ./rebuild_knox_connectome.sh "experiments_exclude_updated.json" "rebuilt" ##automatically writes out 291 regions
  34. ./rebuild_knox_connectome.sh "experiments_exclude_updated.json" "rebuilt_oh_211_regions" ##automatically writes out 211 rgns from Oh et al.
  35. ##################SENSITIVITY ANALYSES############################
  36. ###rebuild connectomes with automated-only experiment inclusions
  37. ./rebuild_oh_connectome.sh "experiments_exclude_updated_automated_only.json" ${oh_rgn_list} "rebuilt_auto"
  38. ./rebuild_knox_connectome.sh "experiments_exclude_updated_automated_only.json" "rebuilt_auto"
  39. ##rebuild connectomes with different number of automated lower outliers for inj/proj voxel counts###
  40. ./rebuild_oh_connectome.sh "experiments_exclude_updated_auto_inj0.5_proj0.1_lower_outliers_6.json" ${oh_rgn_list} "rebuilt_lo_6"
  41. ./rebuild_knox_connectome.sh "experiments_exclude_updated_auto_inj0.5_proj0.1_lower_outliers_6.json" "rebuilt_lo_6"
  42. ./rebuild_oh_connectome.sh "experiments_exclude_updated_auto_inj0.5_proj0.1_lower_outliers_8.json" ${oh_rgn_list} "rebuilt_lo_8"
  43. ./rebuild_knox_connectome.sh "experiments_exclude_updated_auto_inj0.5_proj0.1_lower_outliers_8.json" "rebuilt_lo_8"
  44. ############Leave-One-Out Cross-Validation Analyses from Knox et al.##############
  45. ###this step will take a while
  46. python run_hyperparameter_selection_new_excluded.py
  47. python run_nested_voxel_new_excluded.py
  48. python run_nested_homogeneous_new_excluded.py
  49. ###move old table (if it hasn't already been moved)
  50. if [ ! -f "../mouse_connectivity_models/paper/figures/model_comparison/output/cv_results_voxel-standard_homogeneous-standard-original.csv" ]; then
  51. mv ../mouse_connectivity_models/paper/figures/model_comparison/output/cv_results_voxel-standard_homogeneous-standard.csv \
  52. ../mouse_connectivity_models/paper/figures/model_comparison/output/cv_results_voxel-standard_homogeneous-standard-original.csv
  53. fi
  54. python ../mouse_connectivity_models/paper/figures/model_comparison/compile_table.py
  55. #################################################
  56. #############graph theory analyses###############
  57. cd ..
  58. mkdir -p ../derivatives/regionalized_connectomes/
  59. mkdir -p ../derivatives/rich_club/
  60. mkdir -p ../derivatives/community_louvain/
  61. cd graph_theory
  62. Rscript process_flip_regionalized_connectomes.R
  63. matlab -batch "dbstop if error; rich_club_connectome_bin"
  64. matlab -batch "dbstop if error; community_connectome_bin"
  65. ###########visualizations##########################
  66. cd ..
  67. mkdir -p figures
  68. mkdir -p figures/oh/
  69. mkdir -p "../derivatives/excluded_tracer_aggregate_volumes/"
  70. cd visualizations/
  71. ###misc - manually fill in experiments in query.csv with missing injection regions (available on website)
  72. Rscript fill_in_missing_knox_tracer_regions.R
  73. Rscript figure_1_workflow.R
  74. Rscript figure_2.R
  75. Rscript figure_3.R
  76. ##visualize each combination of thresholds and connectome models
  77. Rscript supp_fig_major_div_connectomes.R "knox" 0.2
  78. Rscript supp_fig_major_div_connectomes.R "knox" 0.05
  79. Rscript supp_fig_major_div_connectomes.R "oh" 0.2
  80. Rscript supp_fig_major_div_connectomes.R "oh" 0.05
  81. Rscript figure_4.R "knox" 0.2
  82. Rscript figure_4.R "oh" 0.2
  83. Rscript figure_4.R "knox" 0.05
  84. Rscript figure_4.R "oh" 0.05
  85. Rscript figure_5.R
  86. ####compare LOOCV tables (Knox et al. vs. post-QC)####
  87. Rscript compare_error_tables.R
  88. ###additional sensitivity analyses added
  89. Rscript sensitivity_analysis.R

run-all-after-manual-QC.sh at commit df87f4e, no license · at the source

Overview

Authors: Vikram Nathan1,2, Stephanie Tullo1, Lizette Herrera-Portillo1,2, Gabriel A Devenyi1,3, Yohan Yee4,5, M Mallar Chakravarty1,3,6
ORCID iDs: Vikram Nathan
  1. Cerebral Imaging Center, Douglas Mental Health University Institute, Montréal, QC, Canada
  2. Integrated Program in Neuroscience, McGill University, Montréal, QC, Canada
  3. Department of Psychiatry, McGill University, Montréal, Canada
  4. Department of Radiology, Cumming School of Medicine, University of Calgary, Calgary, AB, Canada
  5. Experimental Imaging Centre, Cumming School of Medicine, University of Calgary, Calgary, AB, Canada
  6. Department of Biological & Biomedical Engineering, McGill University, Montréal, Canada
Journal: Imaging neuroscience (Cambridge, Mass.), volume 4, article IMAG.a.1310
Dates: received 23 February 2026; accepted 15 June 2026; published online 28 July 2026
Type: Research article · Language: English
License: CC BY
Identifiers: DOI 10.1162/imag.a.1310 · PMID 42529501 · PMCID PMC13417618 · OpenAlex W7167062594
Open access: diamond, a free copy (OpenAlex)
Status: code verified
Categories: mouse (organism), methods / tools (subfield)
Methods: Connectivity, Machine learning, Statistics, fMRI & imaging, Physiology & signal measures
Keywords: connectomics, quality control, tracer-derived connectivity, Allen mouse brain connectivity atlas (AMBCA)
Topic: Functional Brain Connectivity Studies (Cognitive Neuroscience, Neuroscience), according to OpenAlex
Citations: not cited yet (Europe PMC); 72 references in the paper

Abstract

The Allen Mouse Brain Connectivity Atlas (AMBCA) is widely used to represent structural connectivity in the mouse brain. The AMBCA consists of tracer injection experiments where neuronal projections axonally connected to the initial injection site are labeled. The resulting whole-brain structural connectomes, derived from a subset of these experiments in C57BL/6 mice, have been used in several studies of connectomic architectures. However, through close inspection of n = 437 distinct experiments used in a publicly-available connectome (Knox et al., 2018), we observed experiments with off-target injections, diffuse projections, unrealistically small injections and projections, and anatomical misalignments, affecting the accuracy and applicability of these connectivity experiments. We applied a combined automated and manual quality control (QC) and identified n = 56 (~13% of the original n = 437) experiments representing a wide variety of injection and projection failures across the brain. Automated QC was used to detect extreme injection and projection sizes and misalignments, while manual QC was used to detect subtle off-target tracer spreading. Using the remaining n = 381 experiments, we rebuilt two different connectomes using previously-published methods; specifically: the regionalized voxel model from Knox et al. (2018), and the homogeneous model from Oh et al. (2014). Our rebuilt connectomes show strong losses in connectivity between regions with limited evidence of structural connectivity by other methods (e.g., hippocampus-medulla, cerebellum-isocortex) and gains in connectivity between regions with strong connectivity evidence (hypothalamus-cerebellum, hypothalamus-isocortex). Finally, we analyzed the rich club and community organization to demonstrate the potential downstream impacts on the representation of the overall structural connectome architectures of our QC’d connectomes and observed subtle whole-brain organizational changes. We present our rebuilt connectomes, and particularly highlight the regionalized voxel model, as more accurate representations of structural connectivity derived from the AMBCA.

Reproduced under the paper's license (CC BY), from the paper cited above.

Repository

Its files are read in the Code ↔ Paper reader above, with 15 matches between paragraphs and lines of code.

vik16nathan/allen_connectome_qc

License: none: the authors keep all their rights
State: the link answers, verified on 27 September 2026
Evidence: files inventoried
Commit: df87f4e22d1c1b8407fc2d5bfc6c781e93c8a243, 10 August 2026
Languages: Shell (14), R (13), Python (10), MATLAB (2)
Size: 161 files, 39 scripts
Software Heritage: not archived
Found in: “Data and Code Availability”
Holds: README, environment (pyproject.toml)
Not found: license file, CITATION.cff, tests, continuous integration, documentation
Tools: tidyverse (13 files), NumPy (9 files), AllenSDK (6 files), ggplot2 (5 files), scikit-learn (5 files), pandas (4 files), patchwork (4 files), ANTs (3 files), pheatmap (3 files), Brain Connectivity Toolbox (2 files), SciPy (1 file)
Availability: 1 check, the latest on 27 September 2026: the link answers
  • 27 September 2026: the link answers
40 files

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:

  • 1 repository of the authors' code, each at its verified commit, with its license and how the link was found in the paper;
  • 39 scripts, each with its path and the digest of its content;
  • 15 matches between paragraphs of the paper and lines of the code (method lexical-v1);
  • 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

No dataset and no data link were found in the paper.

Data and Code Availability

All code is stored on https://github.com/vik16nathan/allen_connectome_qc. All input data is publicly available and downloaded from the Allen API.

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 2, 28 September 2026

  • Funding: added Douglas Foundation; Canadian Institutes of Health Research; Fonds de Recherche du Québec - Santé

Version 1, 27 September 2026: the first record

Recorded: type, language, journal, volume, pages, dates, 6 authors, 4 keywords, 72 references.

Cite

This paper

Nathan, V., Tullo, S., Herrera-Portillo, L., Devenyi, G. A., Yee, Y., & Chakravarty, M. M. (2026). Experimental quality control induces changes in Allen mouse brain connectomes. Imaging neuroscience (Cambridge, Mass.), 4, IMAG.a.1310. https://doi.org/10.1162/imag.a.1310

BibTeX

@article{nathan2026experimental,
author = {Nathan, Vikram and Tullo, Stephanie and Herrera-Portillo, Lizette and Devenyi, Gabriel A and Yee, Yohan and Chakravarty, M Mallar},
title = {{Experimental quality control induces changes in Allen mouse brain connectomes}},
journal = {Imaging neuroscience (Cambridge, Mass.)},
year = {2026},
month = jul,
volume = {4},
pages = {IMAG.a.1310},
publisher = {MIT Press},
issn = {2837-6056},
doi = {10.1162/imag.a.1310},
url = {https://doi.org/10.1162/imag.a.1310},
pmid = {42529501},
pmcid = {PMC13417618}
}

RIS

TY - JOUR
AU - Nathan, Vikram
AU - Tullo, Stephanie
AU - Herrera-Portillo, Lizette
AU - Devenyi, Gabriel A
AU - Yee, Yohan
AU - Chakravarty, M Mallar
TI - Experimental quality control induces changes in Allen mouse brain connectomes
T2 - Imaging neuroscience (Cambridge, Mass.)
J2 - Imaging Neurosci (Camb)
PY - 2026
DA - 2026/07/28
VL - 4
SP - IMAG.a.1310
SN - 2837-6056
PB - MIT Press
DO - 10.1162/imag.a.1310
UR - https://doi.org/10.1162/imag.a.1310
LA - en
ER -

CSL-JSON

{
"id": "10.1162/imag.a.1310",
"type": "article-journal",
"title": "Experimental quality control induces changes in Allen mouse brain connectomes",
"container-title": "Imaging neuroscience (Cambridge, Mass.)",
"author": [
{
"family": "Nathan",
"given": "Vikram"
},
{
"family": "Tullo",
"given": "Stephanie"
},
{
"family": "Herrera-Portillo",
"given": "Lizette"
},
{
"family": "Devenyi",
"given": "Gabriel A"
},
{
"family": "Yee",
"given": "Yohan"
},
{
"family": "Chakravarty",
"given": "M Mallar"
}
],
"container-title-short": "Imaging Neurosci (Camb)",
"volume": "4",
"page": "IMAG.a.1310",
"DOI": "10.1162/imag.a.1310",
"PMID": "42529501",
"PMCID": "PMC13417618",
"ISSN": "2837-6056",
"publisher": "MIT Press",
"URL": "https://doi.org/10.1162/imag.a.1310",
"language": "en",
"issued": {
"date-parts": [
[
2026,
7,
28
]
]
}
}

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.1038/s41593-026-02253-9 [code]
Genoarchitecture and input-output organization of the mouse basal ganglia and thalamic parafascicular nucleus.
Journal: Nature neuroscience
In common: AllenSDK, scikit-learn, pandas, 2 other tools, mouse, 5 references
[2] doi:10.1038/s41467-026-75723-0 [code]
Spatial transcriptomics reveals distinct cell type dynamics following opioid dependence in female mice with the common human μ-opioid receptor variant Oprm1 A118G.
Journal: Nature communications
In common: AllenSDK, pheatmap, patchwork, 6 other tools, mouse, 1 reference
[3] doi:10.1038/s41467-026-76812-w [code]
Assessing molecular, cellular and transcriptomic bases of laminar perfusion and cytoarchitecture coupling in the human cortex.
Journal: Nature communications
In common: Brain Connectivity Toolbox, ANTs, pheatmap, 7 other tools
[4] doi:10.3389/fnins.2026.1843319 [code]
Humanized APOE mouse brain volume increases over age irrespective of sex and APOE genotype: implications for translational validity to the human.
Journal: Frontiers in neuroscience
In common: ANTs, SciPy, NumPy, mouse, 5 references
[5] doi:10.1162/netn.a.546 [code]
Cortical similarity networks in the rat brain: Postnatal development and sensitivity to early life stress.
Journal: Network neuroscience (Cambridge, Mass.)
In common: patchwork, tidyverse, pandas, 2 other tools, 4 references
[6] doi:10.1126/sciadv.adq6577 [code]
Autism-like phenotypes and increased NMDAR2D expression in mice with KDM5B histone lysine demethylase deficiency.
Journal: Science advances
In common: pandas, SciPy, NumPy, mouse, 5 references
[7] doi:10.1038/s41467-026-76939-w [code]
HIPPIE: a generative model for electrophysiological analysis across species, technologies, and modalities.
Journal: Nature communications
In common: AllenSDK, patchwork, ggplot2, 5 other tools, methods / tools, mouse
[8] doi:10.1038/s41467-026-72161-w [code]
Temporal heterogeneity shapes diffusion dynamics in complex networks.
Journal: Nature communications
In common: Brain Connectivity Toolbox, ggplot2, tidyverse, 3 other tools, mouse, 2 references
[9] doi:10.1038/s41586-026-10629-x [code]
Whole-genome duplication shaped cell-type evolution in the vertebrate brain.
Journal: Nature
In common: pheatmap, patchwork, ggplot2, 5 other tools, mouse, 1 reference
[10] doi:10.1186/s13059-026-04177-w [code]
Genomic sequence evolution underlying human neocortical interareal diversification.
Journal: Genome biology
In common: AllenSDK, pheatmap, ggplot2, 5 other tools, mouse

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.

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: questions and error reports about this paper and its code, from signed-in readers and its authors. It opens with sign-in.

Reproductions: reports from readers who ran the authors' code: what they reproduced, with which environment, commit and data. It opens with sign-in.

Activity: what happens around this paper: new versions of its record, its map's validation, discussions and reproductions. It opens with sign-in.