The initial package of MuCST
Project description
MuCST v1.0
MuCST: restoring and integrating heterogeneous morphology images and spatial transcriptomics data with contrastive learning
Yu Wang, Xiaoke Ma
we present a flexible multi-modal contrastive learning for the integration of spatially resolved transcriptomics (MuCST), including histology image, spatial coordinates and transcription profiles of cells, which jointly perform denoising, elimination of heterogeneity, and compatible feature learning. We demonstrate that MuCST robustly and accurately identifies tissue subpopulations from simulated data with various types of perturbations. In cancer-related tissues, MuCST precisely identifies tumor-associated domains, reveals gene biomarkers for tumor regions, and exposes intratumoral heterogeneity. MuCST is applicable to diverse datasets generated from various platforms, such as STARmap, Visium, and omsFISH for spatial transcriptomics, and hematoxylin and eosin or fluorescence microscopy for images. Overall, MuCST facilitates the integration of multi-modal spatially resolved data, but also serves as pre-processing for data restoration, providing deeper insights into the states, functions, and organization of cells within complex biological tissues.
Installation
pip install mucstpy
Tutorial
The jupyter Notebook of the tutorial for 10 × DLPFC is accessible from : https://github.com/xkmaxidian/MuCST/blob/master/tutorials/SpatialDomainDLPFC.ipynb
The jupyter notebook of the tutorial for 10 $\times$ Human intestine section A1 is accessible from:
https://github.com/xkmaxidian/MuCST/blob/master/tutorials/SpatialDomainIntestine.ipynb
MuCST also applicable to imaging-based ST Platform:
https://github.com/xkmaxidian/MuCST/blob/master/tutorials/SpatialDomainSTARmap.ipynb
Note: Full STARmap data are uploaded at our Zendo.
System Requirements
Python support packages (Python 3.9.18):
scanpy, igraph, pandas, numpy, scipy, scanpy, anndata, sklearn, seaborn, torch, tqdm.
For more details of the used package., please refer to 'requirements.txt' file.
The coding here is a generalization of the algorithm given in the paper. MuCST is written in Python programming language. To use, please clone this repository and follow the instructions provided in the README.md.
File Descriptions:
image_feature.py - Extract morphological information from histology image.
model.py - Base code for construct MuCST model.
loss.py - Loss function of MuCST.
utils.py - Auxiliary functions for the MuCST model.
Compared spatial domain identification algorithms
Algorithms that are compared include:
Contact:
Please send any questions or found bugs to Xiaoke Ma xkma@xidian.edu.cn.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.