# SpaHDmap: deep fusion of spatial transcriptomics and histology images for interpretable high-definition embedding mapping
## Overview

SpaHDmap is based on a multi-modal neural network that takes advantage of the high-dimensionality of transcriptomics
data and the high-definition of image data to achieve interpretable high-definition dimension reduction.
The high-dimensional expression data enable refined functional annotations and the high-definition image data help to
enhance the spatial resolution.
Based on the high-definition embedding and the reconstruction of gene expressions, SpaHDmap can then perform
high-definition downstream analyses, such as spatial domain detection, gene expression recovery, and identification of
embedding-associated genes as well as high-definition cluster-associated genes.
For more details, please refer to our [manuscript](https://www.biorxiv.org/content/10.1101/2024.09.12.612666).
## Installation
Please install `SpaHDmap` from pypi with:
```bash
pip install SpaHDmap
```
Or clone this repository and use
```bash
pip install .
```
in the root of this repository.
## Documentation
Please refer to the [documentation](https://spahdmap.readthedocs.io/en/latest/) for more details, for examples:
- to get the detailed information about installation, please refer to the [installation guide](https://spahdmap.readthedocs.io/en/latest/installation.html).
- to get started with SpaHDmap, please refer to the [tutorials](https://spahdmap.readthedocs.io/en/latest/tutorials/index.html).
- to download the example data, please refer to the [Google Drive](https://drive.google.com/drive/folders/16L1nm3TzDDTFPVAaRXVKRp4LuCqvXbt2)
## License
This software package is licensed under MIT license. For commercial use, please contact [Ruibin Xi](ruibinxi@math.pku.edu.cn).
Raw data
{
"_id": null,
"home_page": null,
"name": "SpaHDmap",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Kun Qian <kunqian@stu.pku.edu.cn>",
"keywords": "spatial transcriptomics, bioinformatics, dimension reduction, deep learning",
"author": null,
"author_email": "Kun Qian <kunqian@stu.pku.edu.cn>, Junjie Tang <junjie.tang@pku.edu.cn>",
"download_url": "https://files.pythonhosted.org/packages/f7/43/6101a498d37ca7934f2515212c2431d7052c454efe7c72f07d057b67d52d/SpaHDmap-0.1.4.tar.gz",
"platform": null,
"description": "# SpaHDmap: deep fusion of spatial transcriptomics and histology images for interpretable high-definition embedding mapping\r\n\r\n## Overview\r\n\r\n\r\n\r\nSpaHDmap is based on a multi-modal neural network that takes advantage of the high-dimensionality of transcriptomics\r\ndata and the high-definition of image data to achieve interpretable high-definition dimension reduction. \r\nThe high-dimensional expression data enable refined functional annotations and the high-definition image data help to\r\nenhance the spatial resolution.\r\n\r\nBased on the high-definition embedding and the reconstruction of gene expressions, SpaHDmap can then perform\r\nhigh-definition downstream analyses, such as spatial domain detection, gene expression recovery, and identification of\r\nembedding-associated genes as well as high-definition cluster-associated genes.\r\n\r\nFor more details, please refer to our [manuscript](https://www.biorxiv.org/content/10.1101/2024.09.12.612666).\r\n\r\n## Installation\r\nPlease install `SpaHDmap` from pypi with:\r\n\r\n```bash\r\npip install SpaHDmap\r\n```\r\n\r\nOr clone this repository and use\r\n\r\n```bash\r\npip install .\r\n```\r\n\r\nin the root of this repository.\r\n\r\n## Documentation\r\n\r\nPlease refer to the [documentation](https://spahdmap.readthedocs.io/en/latest/) for more details, for examples:\r\n- to get the detailed information about installation, please refer to the [installation guide](https://spahdmap.readthedocs.io/en/latest/installation.html).\r\n- to get started with SpaHDmap, please refer to the [tutorials](https://spahdmap.readthedocs.io/en/latest/tutorials/index.html).\r\n- to download the example data, please refer to the [Google Drive](https://drive.google.com/drive/folders/16L1nm3TzDDTFPVAaRXVKRp4LuCqvXbt2)\r\n\r\n## License\r\nThis software package is licensed under MIT license. For commercial use, please contact [Ruibin Xi](ruibinxi@math.pku.edu.cn).\r\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Interpretable high-definition dimension reduction of spatial transcriptomics data by SpaHDmap",
"version": "0.1.4",
"project_urls": {
"Homepage": "https://github.com/sldyns/SpaHDmap"
},
"split_keywords": [
"spatial transcriptomics",
" bioinformatics",
" dimension reduction",
" deep learning"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fa6c7f5de0321c1323b2ebb839d1c151e6e3949bf7dc2f604812226f80fd37c0",
"md5": "aed88ca8eff0b3ab7fd2953b3224ff8c",
"sha256": "9fc1812be56933e0dcf3f88b818aab45d64bccddde3c57196cc3fecfbd63622e"
},
"downloads": -1,
"filename": "SpaHDmap-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "aed88ca8eff0b3ab7fd2953b3224ff8c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 51886,
"upload_time": "2025-08-26T11:56:00",
"upload_time_iso_8601": "2025-08-26T11:56:00.192566Z",
"url": "https://files.pythonhosted.org/packages/fa/6c/7f5de0321c1323b2ebb839d1c151e6e3949bf7dc2f604812226f80fd37c0/SpaHDmap-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f7436101a498d37ca7934f2515212c2431d7052c454efe7c72f07d057b67d52d",
"md5": "32315027266419a185f82affcac19c9a",
"sha256": "4e63122df676fe9265ef53ef17c95f485c27f07c71e088557b966874ad654354"
},
"downloads": -1,
"filename": "SpaHDmap-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "32315027266419a185f82affcac19c9a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 49811,
"upload_time": "2025-08-26T11:56:01",
"upload_time_iso_8601": "2025-08-26T11:56:01.450376Z",
"url": "https://files.pythonhosted.org/packages/f7/43/6101a498d37ca7934f2515212c2431d7052c454efe7c72f07d057b67d52d/SpaHDmap-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-26 11:56:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sldyns",
"github_project": "SpaHDmap",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "spahdmap"
}