Skip to main content

gsMap

Version PyPI version Python Status Project Status Maintenance
Activity GitHub commits Last Commit Quality codecov Ruff
CI/CD Docs test Community GitHub stars GitHub forks
Downloads Downloads License License: MIT DOI
Platform Linux Contribute Issues PRs Welcome

Introduction

gsMap (genetically informed spatial mapping of cells for complex traits) integrates spatial transcriptomics (ST) data with genome-wide association study (GWAS) summary statistics to map cells to human complex traits, including diseases, in a spatially resolved manner.

Key Features

  • Spatially-aware High-Resolution Trait Mapping
  • Spatial Region Identification
  • Putative Causal Genes Identification

Model Architecture

🛠️ Installation

Install using pip:

conda create -n gsMap python>=3.10
conda activate gsMap
pip install gsMap

Install using conda:

conda create -n gsMap python>=3.10
conda activate gsMap
conda install bioconda::gsmap

Install from source:

git clone https://github.com/JianYang-Lab/gsMap
cd gsMap
pip install -e .

Verify the installation by running the following command:

gsmap --help

🤖 AI-assisted Analysis

gsMap supports AI-assisted workflows that allow users to run spatial GWAS analysis using modern AI coding agents and Vibe coding environments. To add the gsMap MCP server and SKILLs in Claude Code:

cd gsMap/gsmap_vibe
uv pip install -e .
claude mcp add gsmap -- python -m gsmap_mcp
cp -r gsmap_skill ~/.claude/skills/

📘 Usage

Please check out the documentation and tutorials at gsMap Documentation.

🌐 Online Visualization

To visualize the traits-cell association spatial maps, please refer to gsMap Visualization.

📖 Citation

Song, L., Chen, W., Hou, J., Guo, M. & Yang, J. Spatially resolved mapping of cells associated with human complex traits. Nature (2025).

Please cite the paper and give us a STAR if you find gsMap useful for your research.

✨ Research Highlight

gsMap was highlighted in Nature Methods.
gsMap was highlighted in Nature Review Genetics.

Metadata

Release files for gsMap 1.73.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gsMap 1.73.8
File Size Uploaded
gsmap-1.73.8.tar.gz 71.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for gsMap 1.73.8
File Interpreter ABI Platform
gsmap-1.73.8-py3-none-any.whl Python 3 none any Details

Total release size: 150.1 kB

Release files / gsmap-1.73.8.tar.gz

Download URL gsmap-1.73.8.tar.gz
Size 71.9 kB
Tags Source
SHA-256 checksum
How to use checksums
e883edb41719276da8472c3fa84d0cd4a70b3a6e5524598d47293a13f087ee8d
BLAKE2b-256 checksum
How to use checksums
1b6f4ccb95823b7ba81f4952a205e9faa5ddbf87d6f343ac812f5e1bf06bd325
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 19, 2026.

Transparency log

Release files / gsmap-1.73.8-py3-none-any.whl

Download URL gsmap-1.73.8-py3-none-any.whl
Size 78.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2c2c0eab82ad0cf69d55373b62656a7232c33215580f5fe3abc62a4917e32837
BLAKE2b-256 checksum
How to use checksums
1bde8a95d873f39ddd8dc5e2e2d233673bbbbcf4a60a88da513bd526b98dc9f2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 19, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

1.73.8 This release

2 release files

1.73.7

2 release files

1.73.5

2 release files

1.73.4

2 release files

1.73.3

2 release files

1.73.2

2 release files

1.73.1

2 release files

1.73.0

2 release files

1.72.3

2 release files

1.71.1

2 release files

1.71

2 release files

1.70

2 release files

1.67

2 release files

1.66

2 release files

1.65

2 release files

1.64

2 release files

1.63

2 release files

1.62

2 release files

1.60

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page