Skip to main content

Downloads License: MIT Python 3.9+ medRxiv

AESTETIK: AutoEncoder for Spatial Transcriptomics Expression with Topology and Image Knowledge

This model is part of the paper "Representation learning for multi-modal spatially resolved transcriptomics data".

Authors: Kalin Nonchev, Sonali Andani, Joanna Ficek-Pascual, Marta Nowak, Bettina Sobottka, Tumor Profiler Consortium, Viktor Hendrik Koelzer, and Gunnar Rätsch

The preprint is available here.

News

Changelog

NEW version (June 2025)

  • UPDATE: Rewrote AESTETIK using the Lightning framework for improved modularity
  • Added: New fit()/predict() API
  • Added: Support for processing multiple samples at once
  • Removed: Multiple old methods and parameters in AESTETIK

See full changelog for more details.

Do you want to gain a multi-modal understanding of key biological processes through spatial transcriptomics?

We introduce AESTETIK, a convolutional autoencoder model. It jointly integrates transcriptomics and morphology information, on a spot level, and topology, on a neighborhood level, to learn accurate spot representations that capture biological complexity.

aestetik

Fig. 1 AESTETIK integrates spatial, transcriptomics, and morphology information to learn accurate spot representations. A: Spatial transcriptomics enables in-depth molecular characterization of samples on a morphology and RNA level while preserving spatial location. B: Workflow of AESTETIK. Initially, the transcriptomics and morphology spot representations are preprocessed. Next, a dimensionality reduction technique (e.g., PCA) is applied. Subsequently, the processed spot representations are clustered separately to acquire labels required for the multi-triplet loss. Afterwards, the modality-specific representations are fused through concatenation and the grid per spot is built. This is used as an input for the autoencoder. Lastly, the spatial-, transcriptomics-, and morphology-informed spot representations are obtained and used for downstream tasks such as clustering, morphology analysis, etc.

Setup

We can install aestetik directly through pip.

pip install aestetik

We can also create a conda environment with the required packages.

conda env create --file=environment.yaml

We can also install aestetik offline.

git clone https://github.com/ratschlab/aestetik
cd aestetik
pip install .

Optional extras:

pip install ".[vips]"   # enables pyvips-based morphology helpers
pip install ".[viz]"    # enables plotnine-based cluster-search plot
pip install ".[test]"   # test dependencies (pytest)
NB: The morphology spot-extraction helpers require pyvips. We recommend installing pyvips through conda:
conda install conda-forge::pyvips

Getting Started

After installing, confirm the version with import aestetik; aestetik.__version__. AESTETIK follows the scikit-learn fit / transform / predict estimator surface:

from aestetik import AESTETIK

model = AESTETIK(
    n_cluster=adata.obs.ground_truth.unique().size,
    morphology_weight=1.5,
    refine_cluster=True,
    window_size=3,
    clustering_method="kmeans",
)
model.fit(adata)
adata.obsm["AESTETIK"]        = model.transform(adata)
adata.obs["AESTETIK_cluster"] = model.predict(adata)

# Or in one shot:
adata.obs["AESTETIK_cluster"] = model.fit_predict(adata)

Please take a look at our example to get started with AESTETIK.

aestetik

Here, another example notebook with simulated spatial transcriptomics data.

aestetik

Papers Citing AESTETIK

  1. Ju Dai, Kalin Nonchev, V. Koelzer, and Gunnar Rätsch "Towards Cross-Sample Alignment for Multi-Modal Representation Learning in Spatial Transcriptomics." bioRxiv (2026). DOI
  2. Kalin Nonchev, Glib Manaiev, V. Koelzer, and Gunnar Rätsch "DeepSpot2Cell: Predicting Virtual Single-Cell Spatial Transcriptomics from H&E images using Spot-Level Supervision." bioRxiv (2025). DOI
  3. Liping Kang, Qinglong Zhang, F. Qian, Junyao Liang, and Xiaohui Wu "Benchmarking computational methods for detecting spatial domains and domain-specific spatially variable genes from spatial transcriptomics data." Nucleic Acids Research (2025). DOI
  4. Kalin Nonchev, Sebastian Dawo, Karina Silina, H. Moch, S. Andani, Tumor Profiler Consortium, V. H. Koelzer, and Gunnar R¨atsch "DeepSpot: Leveraging Spatial Context for Enhanced Spatial Transcriptomics Prediction from H&E Images." medRxiv (2025). DOI

This list is automatically updated weekly via GitHub Actions using the Semantic Scholar and OpenCitations APIs.

  • DeepSpot — Predicts spatial transcriptomics from H&E images at spot-level (Visium) and single-cell (Xenium) resolution. Uses AESTETIK for cross-sample integration.
  • DeepSpot2Cell — Predicts virtual single-cell spatial transcriptomics from H&E images using spot-level supervision.

Citation

In case you found our work useful, please consider citing us:

@article{nonchev2024representation,
  title={Representation learning for multi-modal spatially resolved transcriptomics data},
  author={Nonchev, Kalin and Andani, Sonali and Ficek-Pascual, Joanna and Nowak, Marta and Sobottka, Bettina and Tumor Profiler Consortium and Koelzer, Viktor Hendrik and Raetsch, Gunnar},
  journal={medRxiv},
  pages={2024--06},
  year={2024},
  publisher={Cold Spring Harbor Laboratory Press}
}

The code for reproducing the paper results can be found here.

Contact

In case, you have questions, please get in touch with Kalin Nonchev.

Metadata

Release files for aestetik 0.3.1

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

Source distribution (sdist)

Source distribution for aestetik 0.3.1
File Size Uploaded
aestetik-0.3.1.tar.gz 45.0 kB Details

Built distribution (wheel)

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

Total release size: 78.0 kB

Release files / aestetik-0.3.1.tar.gz

Download URL aestetik-0.3.1.tar.gz
Size 45.0 kB
Tags Source
SHA-256 checksum
How to use checksums
6df36e32a34d9e3e9e0f796e68dccbdb9b0bad141a3888303ccc7596f7ba39f5
BLAKE2b-256 checksum
How to use checksums
8c24316574d33d23c84b62041b6bc2879b3c48ceb19fd872d779a2a8c3d18ec4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Release files / aestetik-0.3.1-py3-none-any.whl

Download URL aestetik-0.3.1-py3-none-any.whl
Size 32.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a2d39ff4b30ea692d9d93e6cc65911f45b198f47dd9f70829e6ba21ce816e781
BLAKE2b-256 checksum
How to use checksums
7555b20a17ed8a1f959d196b8529b09bdbff0f8ed42854fb27af97a10121e665
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Release history Release notifications | RSS feed

This release

0.3.1 This release

2 release files

0.1.0

2 release files

0.0.2

1 release file

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