Skip to content

Latest commit

 

History

History
99 lines (63 loc) · 3.39 KB

README.rst

File metadata and controls

99 lines (63 loc) · 3.39 KB

Integrated analysis platform of tissue histology and spatial transcriptomics at the cell level

Thor enables cell-level spatial transcriptomics analysis by integrating histology and transcriptomic information through an anti-shrinking Markov diffusion method.

Key features:

  • Jointly leverages histological and transcriptomic information for accurate inference
  • Achieves single-cell resolution without requiring additional single-cell reference data

workflow

Thor modules

function

What's new

  • 🚀 2025-09-16: Added tutorial for running copy number aberration in the notebooks/ directory
  • 🚀 2025-09-03: Updated preprocessing scripts for Visium HD data and added a new tutorial in the visiumhd/ directory
  • 🧬 Added full support for Visium HD data
  • 🔗 Integrated COMMOT for cell–cell communication analysis

Installation

Thor is written in Python (3.9+) and tested on macOS and Linux. We recommend installing it inside a virtual environment.

Step 1. Create a virtual environment (recommended)

Using conda:

conda create -n Thor python=3.9
conda activate Thor

Step 2. Clone the repository

git clone https://github.com/GuangyuWangLab2021/Thor.git
cd Thor

Step 3. Install Thor

  • Base installation:

    pip install .
  • With optional visualization and advanced analysis:

    pip install ".[vis,analysis]"

Cell–cell communication (COMMOT)

Currently, Thor includes COMMOT, a state-of-the-art tool for spatial communication analysis. This module is under active development, and we welcome feedback and contributions.

Requirements:

  • R (tested with version 4.2.2)

  • Python dependencies:

    pip install --no-deps commot@git+https://github.com/biopzhang/COMMOT.git
    pip install karateclub@git+https://github.com/benedekrozemberczki/karateclub.git POT libpysal rpy2==3.5.11 anndata2ri==1.2

Usage

Frequently Asked Questions

(Coming soon – please open an issue if you have questions you’d like us to cover!)

Support

Please report bugs, request features, or share feedback on the GitHub Issues page.