Skip to main content

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

Project description

Downloads

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

  • [08.2024] AESTETIK secured the 1st place at the Mammoth International Contest On Omics Sciences in Europe 2024 organized by China National GeneBank, BGI Genomics, MGI and CODATA link.

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
python setup.py install
NB: Please ensure you have installed pyvips depending on your machine's requirements. We suggest installing pyvips through conda:
conda install conda-forge::pyvips

Getting Started

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

aestetik

Here, another example notebook with simulated spatial transcriptomics data.

aestetik

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aestetik-0.1.0.tar.gz (19.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aestetik-0.1.0-py3-none-any.whl (20.1 kB view details)

Uploaded Python 3

File details

Details for the file aestetik-0.1.0.tar.gz.

File metadata

  • Download URL: aestetik-0.1.0.tar.gz
  • Upload date:
  • Size: 19.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.18

File hashes

Hashes for aestetik-0.1.0.tar.gz
Algorithm Hash digest
SHA256 912fb98c6c5410893a5456b28098fc8eb82d6efc423f56ff8124214fd7546c67
MD5 dce7ba8d6cd16cb267fc91db790cffe2
BLAKE2b-256 2adf8ba39b143a5b635f7a0874d79b1ab05b52d935033a762bd9fdf311c31e31

See more details on using hashes here.

File details

Details for the file aestetik-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: aestetik-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 20.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.18

File hashes

Hashes for aestetik-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bba81018023faa4cf81d03ef45cd78c6690309a0b7b9a7ff4b3799af324445cf
MD5 be6804009b1db48af2e8d525660dc0f0
BLAKE2b-256 b40ac35f2ead898ae9b8b08117e8da2b1a2caf1e6758bbb4a811ec9b2bcd0d6a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page