Skip to content

The source code for "High-Parameter Spatial Multi-Omics through Histology-Anchored Integration"

License

Notifications You must be signed in to change notification settings

KEAML-JLU/SpatialEx

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SpatialEx

High-Parameter Spatial Multi-Omics through Histology-Anchored Integration

Nature Methods BioRxiv Tutorials

SpatialEx is a powerful tool for high-parameter spatial multi-omics analysis through histology-anchored integration. This repository contains the source code and implementation for our published work.


📚 Table of Contents


Overview

SpatialEx enables high-parameter spatial multi-omics analysis by integrating histology information with multi-omics data. The published version and preprint of our work are available at:

📘 Step-by-step tutorials are available at our documentation site.


Architecture

Overall Architecture of SpatialEx and SpatialEx+

Architecture


Installation

Quick Install

Install SpatialEx directly from PyPI:

pip install SpatialEx

Install from Requirements

Alternatively, install from the requirements file:

pip install -r requirements.txt

Manual Installation

If you prefer to install packages individually to avoid potential conflicts, here are the key dependencies:

pip install anndata==0.8.0
pip install scanpy==1.9.3
pip install numpy==1.23.5
pip install pandas==2.0.3
pip install cellpose==3.0.10
pip install scikit-image==0.21.0
pip install scikit-learn==1.3.2
pip install scikit-misc==0.2.0
pip install torch==2.3.1
pip install huggingface-hub==0.24.6
pip install timm==1.0.8
pip install torchvision==0.18.1

⚠️ Note: We recommend installing the above Python packages one by one to avoid potential dependency conflicts.


Usage

We have packaged our implementation into an easy-to-use Python library for the research community.

  • 📖 Detailed Installation Guide: Tutorial Documentation
  • 📓 Comprehensive Examples: See Demonstration.ipynb for detailed guides to all applications in the paper

Datasets

Processed Data

The processed data generated in this study are available on Google Drive:

🔗 Download Processed Data

Public Datasets

🧬 Xenium Human Breast Cancer Tissue Dataset

🧬 10x Xenium Human Breast (Entire Sample Area)

🧬 Spatial Multimodal Analysis (SMA) Dataset

Preprocessed Data from Other Studies

The preprocessed IF data for Xenium Human Breast Cancer Rep1 and mouse brain SMA data were obtained from another study:

⚠️ Important: Please cite the NicheTrans study when using their preprocessed data.


Citation

If you find our work useful, please cite our paper:

@article{liu2025high,
  title={High-Parameter Spatial Multi-Omics through Histology-Anchored Integration},
  author={Liu, Yonghao and Wang, Chuyao and Wang, Zhikang and Chen, Liang and Li, Zhi and Song, Jiangning and Zou, Qi and Gao, Rui and Qian, Binzhi and Feng, Xiaoyue and Guan, Renchu and Yuan, Zhiyuan},
  journal={Nature Methods},
  year={2025}
}

Contact

If you have any questions or need support, please feel free to contact us:

About

The source code for "High-Parameter Spatial Multi-Omics through Histology-Anchored Integration"

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors