Published September 29, 2025 | Version v1
Dataset Open

Demonstration data and code: A guide to D-SPIN

  • 1. ROR icon Rockefeller University
  • 2. ROR icon California Institute of Technology

Description

D-SPIN (Dimension-scalable Single-cell Perturbation Integration Network) is a computational framework for constructing regulatory network models from large-scale single-cell perturbation data. D-SPIN models the transcriptional state of cells as a set of individual genes or gene programs that interact through a condition-dependent spin network model or Markov random field. A single unified network is learned across multiple conditions, where the perturbations modulate the activity of individual network nodes. The architecture allows information integration between different perturbation conditions and supports efficient inference algorithms that scale to thousands of genes, thousands of conditions, and millions of single cells. For interpretability, D-SPIN can also operate at the level of programs of co-expressing genes sets, which are extracted via unsupervised orthogonal non-negative matrix factorization (oNMF). Here we present the theory and detailed procedures for applying D-SPIN to build program-level or gene-level network models from single-cell data. With a public immune dictionary dataset, we illustrate multiple applications of D-SPIN, including identifying gene programs and network modules, classifying perturbation responses of cytokines, and nominating key regulators that mediate cytokine responses. 

Files

dspin_demo_immune_dictionary.ipynb
Files (471.4 MB)
Name Size
md5:acf441cf848ce71a94db5634ac556950
175.6 MB Download
md5:8e842904c4309f6ce91535a40dce3057
320.6 kB Download
md5:7f42dacbc84052f0146478c8960592a1
3.8 kB Download
md5:47b451ef6b6e0ce5d2cbd5a3846f0fc1
189.7 MB Download
md5:74262f173fb92e32dc9bbfacdbdc3961
2.3 MB Preview Download
md5:a5bfec6a1ddefdb119ce29eaba921d49
2.0 kB Download
md5:af6e90c3caf15c9f5a830582a718c98b
103.5 MB Download

Additional details

Created:
October 3, 2025
Modified:
October 3, 2025