agentsclimarketplace

Autoencoder encoder decoder design

Skill HolobiomicsLab/asb-skill-collections/packs/metabolomics/ms-imaging/skills/autoencoder-encoder-decoder-design

Use when when working with imaging mass spectrometry (IMS) datasets where you need to extract latent low-dimensional peak features from high-dimensional peak intensity data while preserving spatial adjacency information.From its SKILL.md

Install
npx -y skills add HolobiomicsLab/asb-skill-collections --skill autoencoder-encoder-decoder-design

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as CC-BY-4.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

6.8 KB, ~1.0k tokens by cl100k_base, as published. Nobody here has run it

autoencoder-encoder-decoder-design

Summary

Design and implement a graph-attention autoencoder architecture that maps imaging mass spectrometry peak intensities into low-dimensional latent representations and reconstructs them. This skill enables automatic feature extraction from spatial metabolomics data for downstream peak picking and marker ion identification.

When to use

When working with imaging mass spectrometry (IMS) datasets where you need to extract latent low-dimensional peak features from high-dimensional peak intensity data while preserving spatial adjacency information. Use this skill when your goal is to enable iterative automatic peak picking or marker ion identification in spatial metabolomics studies.

When NOT to use

  • Input data lacks spatial structure or adjacency information; use a standard autoencoder instead
  • Peak intensities are already in a processed low-dimensional latent space
  • Computational resources are severely constrained; graph-attention layers have higher complexity than fully-connected autoencoders

Inputs

  • Imaging mass spectrometry (IMS) dataset as HDF5 or scanpy-compatible format
  • Peak intensity matrix with spatial adjacency graph structure
  • Node features (peak intensities) and edge information (spatial neighbors)

Outputs

  • Latent low-dimensional peak feature representations
  • Reconstructed peak intensity features
  • Trained graph-attention autoencoder model

How to apply

First, define a graph-attention autoencoder architecture by implementing graph-attention encoder layers that process node features (peak intensities) and edge information (spatial adjacency) from your IMS data. Implement the encoder to progressively reduce dimensionality through one or more graph-attention layers down to your target latent dimension. Then implement a symmetric decoder using transposed graph-attention or fully-connected layers to reconstruct peak intensities from latent vectors. Assemble the complete autoencoder by chaining encoder and decoder components, ensuring the forward pass accepts spatial graph tensors as input and outputs both reconstructed peak intensities and latent representations. Validate that latent features capture peak identity and spatial structure by inspecting their utility in downstream peak picking tasks.

Related tools

  • scanpy (Manage and process imaging mass spectrometry data structures)
  • STAGATE (Provide graph-attention layer implementations and spatial graph construction)
  • pandas (Handle tabular peak intensity and metadata formats)
  • h5py (Read and write HDF5-formatted IMS datasets)

Evaluation signals

  • Forward pass accepts spatial graph tensors (nodes, edges) and outputs latent vectors with expected dimensionality matching the target latent dimension
  • Reconstruction loss (MSE or similar) on held-out peak intensity data decreases monotonically during training
  • Latent representations enable accurate marker ion identification and automatic peak picking in downstream tasks compared to baseline methods
  • Decoder successfully reconstructs peak intensity distributions with fidelity comparable to input data statistics
  • Latent features from the encoder show meaningful clustering or separation of chemically distinct peaks when visualized in 2D/3D space

Limitations

  • Requires well-defined spatial adjacency graph; missing or noisy spatial information may degrade latent feature quality
  • Graph-attention layers scale computationally with graph size; very large IMS datasets may require subsampling or tiling strategies
  • Hyperparameter tuning (latent dimension, number of attention heads, encoder depth) is data-dependent and may require cross-validation
  • No changelog or version history provided in the SmartGate repository, limiting reproducibility across releases

Evidence

  • [other] SmartGate employs a graph-attention autoencoder architecture that generates latent low-dimensional peak features from imaging mass spectrometry datasets to enable automatic peak picking and marker ion identification.: "SmartGate employs a graph-attention autoencoder architecture that generates latent low-dimensional peak features from imaging mass spectrometry datasets to enable automatic peak picking and marker"
  • [other] Define the graph-attention autoencoder architecture with graph-attention encoder layers that process node features (peak intensities) and edge information (spatial adjacency) from IMS data.: "Define the graph-attention autoencoder architecture with graph-attention encoder layers that process node features (peak intensities) and edge information (spatial adjacency) from IMS data"
  • [other] Implement the encoder to map input peak intensity features through one or more graph-attention layers, reducing dimensionality progressively to the target latent dimension.: "Implement the encoder to map input peak intensity features through one or more graph-attention layers, reducing dimensionality progressively to the target latent dimension"
  • [other] Implement the decoder to reconstruct peak intensity features from latent vectors using transposed graph-attention or fully-connected layers, mirroring the encoder structure.: "Implement the decoder to reconstruct peak intensity features from latent vectors using transposed graph-attention or fully-connected layers, mirroring the encoder structure"
  • [readme] SmartGate could get latent low dimension peak features by Graph-attention autoencoder which help us achieve automic peak picking iteratively to find the marker ions: "SmartGate could get latent low dimension peak features by Graph-attention autoencoder which help us achieve automic peak picking iteratively to find the marker ions"

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 326,835. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.