agentsclimarketplace

High dimensional signal enhancement

Skill HolobiomicsLab/asb-skill-collections/packs/metabolomics/ce-ms/skills/high-dimensional-signal-enhancement

Use when when you have raw or preprocessed mass spectrometry imaging (MSI) data with limited spatial resolution, high noise, or incomplete molecular coverage, and you want to enhance signal fidelity to support multiscale tissue–single-cell mapping or brain biochemical profiling.From its SKILL.md

Install
npx -y skills add HolobiomicsLab/asb-skill-collections --skill high-dimensional-signal-enhancement

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

  • 15 stars15 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

8.2 KB, ~1.3k tokens by cl100k_base, as published. Nobody here has run it

high-dimensional-signal-enhancement

Summary

Deep learning reconstruction of high-throughput mass spectrometry signals to enhance signal quality and enable multiscale biochemical mapping of tissue and single-cell samples. This skill uses a trained neural network decoder to reconstruct noisy or undersampled mass spectrometry data, improving spatial resolution and molecular coverage for downstream integrative analysis.

When to use

When you have raw or preprocessed mass spectrometry imaging (MSI) data with limited spatial resolution, high noise, or incomplete molecular coverage, and you want to enhance signal fidelity to support multiscale tissue–single-cell mapping or brain biochemical profiling. Typical triggers: MSI data acquired at low mass resolution; serial tissue sections requiring consistent signal reconstruction across slides; need to integrate high-resolution tissue MSI with single-cell mass spectrometry datasets.

When NOT to use

  • Input data is already high-resolution, high signal-to-noise MSI acquired at target mass resolution; reconstruction adds minimal benefit and increases computational cost.
  • Mass spectrometry data is from a fundamentally different instrument type or ionization mode than the MEISTER training set; domain shift may degrade reconstruction accuracy without retraining.
  • Analysis goal does not require spatial integration or multiscale mapping; simple spectral or peak-table analysis does not need signal reconstruction.

Inputs

  • Raw mass spectrometry transient files (.d Bruker format)
  • Peak intensity matrices (imzML format)
  • Preprocessed MSI feature matrices (HDF5 .h5 or NumPy array)
  • High-resolution reference MSI data for model training
  • Mass spectrometry single-cell datasets (imzML peak data)

Outputs

  • Reconstructed MSI feature matrices (imzML or HDF5 .h5)
  • Trained model weights (decoder and regressor checkpoints)
  • Reconstruction loss/accuracy metrics on validation data
  • Enhanced peak intensity maps at target mass resolution
  • Latent feature embeddings for downstream integrative analysis

How to apply

Load raw mass spectrometry feature matrices (imzML or .d Bruker format) and prepare them as input tensors matching the MEISTER model architecture. Initialize a pretrained or newly configured deep learning decoder and regressor with appropriate hyperparameters (learning rate, batch size, latent dimensionality). Train the reconstruction model on high-resolution reference MSI data using the MEISTER training pipeline, or apply a pretrained model checkpoint (e.g., saved_model.zip from the manuscript) to low-resolution input data. Evaluate reconstruction fidelity using held-out test MSI sections, computing loss metrics and comparing reconstructed peak intensities to ground-truth or validation reference data. Save decoded feature matrices in imzML or HDF5 format (.h5) for downstream multiscale analysis (3D registration, regional segmentation, cell-type mapping).

Related tools

  • MEISTER (Deep learning reconstruction module that processes mass spectrometry data via trainable decoder and regressor networks to enhance signal fidelity and enable multiscale analysis) — https://github.com/richardxie1119/MEISTER
  • multiscale_analysis (Companion repository providing Jupyter notebooks for post-reconstruction 3D data processing, embedding, atlas registration, and tissue–single-cell integrative mapping) — https://github.com/richardxie1119/multiscale_analysis

Evaluation signals

  • Reconstruction loss on held-out test MSI sections is lower than baseline (untrained model or classical interpolation), and loss convergence plateau indicates model has learned stable signal patterns.
  • Reconstructed peak intensity distributions across spatial coordinates match ground-truth reference data; compare via mean absolute error (MAE) or Pearson correlation on validation sections.
  • Post-reconstruction feature images (e.g., via parametric UMAP embedding) show coherent spatial organization consistent with known brain anatomy (e.g., distinct hippocampal or cortical layers).
  • Tissue MSI reconstructed data and single-cell MS data integrate successfully (e.g., tissue cells map to single-cell clusters with >70% assignment consistency in unsupervised cell-type mapping).
  • Output imzML or HDF5 files decode without errors in downstream analysis notebooks; pixel intensity ranges and metadata (m/z, spatial coordinates) are preserved and consistent.

Limitations

  • Model performance depends on quality and representativeness of the training reference MSI dataset; domain shift to new tissue types or instrument configurations may require retraining.
  • Reconstruction does not recover molecular signals absent or extremely weak in the raw input; primarily enhances and denoise existing signal, not invent new species.
  • Computational cost is high for 3D coronal datasets (serial sections); GPU memory and training time scale with data dimensionality and model depth.
  • README notes that code documentation is still under expansion ('We are expanding our code documentations to make it friendly'), so detailed parameter tuning guidance may be limited.

Evidence

  • [other] MEISTER implements deep learning reconstruction as a component that processes mass spectrometry data to enable multiscale and integrative analysis of both tissue and single-cell samples.: "MEISTER implements deep learning reconstruction as a component that processes mass spectrometry data to enable multiscale and integrative analysis of both tissue and single-cell samples."
  • [readme] Multiscale and integrative analysis of tissue and single cells using mass spectrometry with deep learning reconstruction.: "Multiscale and integrative analysis of tissue and single cells using mass spectrometry with deep learning reconstruction."
  • [readme] The documentation for training MEISTER signal models for reconstruction can be found [here]. The complete computational protocol for reconstruction and downstream multiscale data analysis can be found in the online Supplementary Information.: "The documentation for training MEISTER signal models for reconstruction can be found [here]. The complete computational protocol for reconstruction and downstream multiscale data analysis can be"
  • [other] Configure and initialize the deep learning model with appropriate hyperparameters for the reconstruction task. Train the reconstruction model on the mass spectrometry data using the MEISTER training pipeline. Evaluate the trained model on held-out test data, computing reconstruction accuracy or loss metrics.: "Configure and initialize the deep learning model with appropriate hyperparameters for the reconstruction task. Train the reconstruction model on the mass spectrometry data using the MEISTER training"
  • [readme] saved_model.zip: trained model weights (decoder and regressor) on high-resolution MSI data used in the manuscript.: "saved_model.zip: trained model weights (decoder and regressor) on high-resolution MSI data used in the manuscript."

What ships with it

Read from the repository

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

Keep looking

Skills are one crate of 325,949. 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.