Sovereign 8s.is mirror of standardgalactic/2026_NI_Manuscript
  • Python 99.9%
  • Dockerfile 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Max Cowan 8536b1b51f
Update README with article status and requirements
Added a note about the article status and updated requirements.
2026-04-23 18:33:04 +01:00
docs/attachments modified readme 2026-04-23 17:08:43 +01:00
notebooks@7b0fde7010 Add notebooks as submodule 2026-04-23 16:46:48 +01:00
scripts commit codebase 2026-04-23 16:44:04 +01:00
signatures commit codebase 2026-04-23 16:44:04 +01:00
src commit codebase 2026-04-23 16:44:04 +01:00
tests commit codebase 2026-04-23 16:44:04 +01:00
.gitignore commit codebase 2026-04-23 16:44:04 +01:00
.gitmodules Add notebooks as submodule 2026-04-23 16:46:48 +01:00
Dockerfile commit codebase 2026-04-23 16:44:04 +01:00
environment.yml commit codebase 2026-04-23 16:44:04 +01:00
LICENSE Initial commit 2026-04-20 12:52:50 +01:00
README.md Update README with article status and requirements 2026-04-23 18:33:04 +01:00
requirements.txt commit codebase 2026-04-23 16:44:04 +01:00

2026 NI Manuscript

Materials and code for analysis in 2026 Manuscript. Spatial analysis of PI16+ Fibroblasts, PRG4+ Fibroblasts, and VWF+ endothelium across whole, human, developmental manual digits with accompanying tissue annotations for compartment analysis.

Davidson, Simeone, and Jansen et. al. 2026, Fig.5f
@article{TBA,
  title={The embryonic origins of site-specific arthritis},
  author={Sarah Davidson*, Davide Simone*, Kathrin Jansen*, Max Cowan, Caio Machado, Ian Reekie, Ananya Bhalla, Rowie Borst, Cesar Prada Medina, Joshua Bull, Zhi Yi Wong, Sarah Hill, Micon Garvilles, Sam Pledger, Patricia Reis Nisa, Nora Schwingen, Dylan Windell, Moustafa Attar, Catherine Disney, Andrew J Bodey, Alissa Parmenter, Helen Byrne, Sharif Ahmed, Shashidhara Marathe, Peter D Lee, Chris Mahony, Adam P Croft, Stephen Sansom#, Mark C Coles# Christopher D Buckley#},
  year={2026}
}

* These authors contributed equally
# These authors jointly supervised this work

Please note, article in press

Environment Setup

Requirements

  • CUDA 12.1 compatible GPU (≥8 GB VRAM recommended)
  • conda or mamba
mamba env create -f environment.yml
conda activate ni_manuscript

Option B: Docker (GPU)

docker build -t ni_manuscript .
docker run --gpus all -it --rm -v $(pwd):/workspace ni_manuscript

Note on MuSpAn: This package is not on PyPI - See https://docs.muspan.co.uk for documentation.

Workflow

For full methods (including data collection and staining protocols / procedures) please refer to the original publication. Images acquired samples derived from 3 donors on the CellDIVE platform (20x magnification, 0.325µm/pixel) with 4 markers: DAPI (DAPI_INIT and DAPI_FINAL), PI16, PRG4, and VWF.

Ingest and Segmentation

  • run_batch_analysis.py calling run_spatial_analysis.py.

Sample phenotyping

Cell types were phenotyped by mixed methods, including graph-based clustering per sample. The latter was used for downstream analysis.

Spatial Analysis

  • Generate metadata file: generate_metadata_from_samples.py
  • run_spatial_statistics_v3.py

Proximal/Distal Enrichment

python scripts/prox_dist_enrichment_analysis.py --data-dir /path/to/data/processed/prox_dist
# Optional: specify a separate output directory
python scripts/prox_dist_enrichment_analysis.py --data-dir ./data/processed/prox_dist --output-dir ./results/enrichment

References and acknowledgements

Please refer to the original manuscript for full acknowledgements and references.
Particularly grateful to the developers and maintainers of MuSpAn, SpatialData, and CellPose.

@article{bull2024muspan,
  title={MuSpAn: a toolbox for multiscale spatial analysis}, 
  author={Bull, Joshua A and Moore, Joshua W and Mulholland, Eoghan J and Leedham, Simon J and Byrne, Helen M},
  journal={bioRxiv},
  year={2024},
  publisher={Cold Spring Harbor Laboratory}
}
@article{marconato2025spatialdata,
  title={SpatialData: an open and universal data framework for spatial omics},
  author={Marconato, Luca and Palla, Giovanni and Yamauchi, Kevin A and Virshup, Isaac and Heidari, Elyas and Treis, Tim and Vierdag, Wouter-Michiel and Toth, Marcella and Stockhaus, Sonja and Shrestha, Rahul B and others},
  journal={Nature methods},
  volume={22},
  number={1},
  pages={58--62},
  year={2025},
  publisher={Nature Publishing Group US New York}
}
@article{stringer2021cellpose,
  title={Cellpose: a generalist algorithm for cellular segmentation},
  author={Stringer, Carsen and Wang, Tim and Michaelos, Michalis and Pachitariu, Marius},
  journal={Nature methods},
  volume={18},
  number={1},
  pages={100--106},
  year={2021},
  publisher={Nature Publishing Group US New York}
}

Data Availability

Data Repository: https://www.ebi.ac.uk/biostudies/bioimages/studies/S-BIAD3270