Image processing on two dimensional mass spectrometry maps
Use when when you have raw GC–MS data in two-dimensional m/z × retention time format (NetCDF or proprietary binary) and need to identify marker features across aroma or breath samples at parts-per-billion concentration levels, particularly when conventional peak picking introduces false positives.From its SKILL.md
npx -y skills add HolobiomicsLab/asb-skill-collections --skill image-processing-on-two-dimensional-mass-spectrometry-mapsAssembled 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
7.1 KB, ~1.0k tokens by cl100k_base, as published. Nobody here has run it
image-processing-on-two-dimensional-mass-spectrometry-maps
Summary
Apply image processing and machine learning to two-dimensional mass spectrometry maps (m/z vs. retention time) to automatically identify and visualize multivariate chemo-/biomarker features without conventional peak picking. This skill enables marker identification in GC–MS data at parts-per-billion sensitivity levels with lower error rates than traditional peak-picking workflows.
When to use
When you have raw GC–MS data in two-dimensional m/z × retention time format (NetCDF or proprietary binary) and need to identify marker features across aroma or breath samples at parts-per-billion concentration levels, particularly when conventional peak picking introduces false positives or when you lack predefined peak models.
When NOT to use
- Input data is already a processed feature table or peak list (skip to statistical analysis).
- Target analytes have very high m/z variability or retention time drift that exceeds the image registration assumptions.
- Analysis requires targeted quantitation with predefined MS/MS fragmentation patterns; image processing alone may miss structured spectral relationships.
Inputs
- raw GC–MS data in two-dimensional m/z vs. retention time format (NetCDF, proprietary binary)
- two-dimensional MS map (m/z × retention time image array)
- reference marker annotations or ground-truth peak positions (for validation)
Outputs
- identified marker feature coordinates (m/z, retention time pairs)
- visualized marker features overlaid on 2D MS map
- signal acquisition error rates
- marker identification error rates
- quantified analyte abundance or intensity values
How to apply
Load raw GC–MS data as a two-dimensional image array where axes represent m/z and retention time. Apply NPFimg's image processing pipeline to segment and discriminate analytes within the 2D MS map without invoking traditional peak detection algorithms. The method combines spatial filtering, connected-component analysis, and machine learning classifiers trained on reference marker positions to reduce false signal artifacts. Quantify error rates for both signal acquisition and marker identification against a baseline (e.g., XCMS) on the same dataset. The workflow avoids peak picking altogether, instead leveraging pixel-level image features to directly extract marker coordinates and intensities.
Related tools
- NPFimg (Primary implementation: combines image processing and machine learning to process 2D MS maps and identify marker features without peak picking) — github.com/poomcj/NPFimg
- XCMS (Baseline comparison tool: traditional peak-picking workflow used to benchmark NPFimg error rates on the same GC–MS datasets)
Evaluation signals
- Error rates for signal acquisition and marker identification are lower than or comparable to XCMS on the same dataset.
- Marker feature coordinates (m/z, retention time) align with visually inspected 2D MS map features and known reference compounds.
- No false peaks are introduced by conventional peak-picking artifacts (e.g., baseline noise spikes).
- Parts-per-billion level marker sensitivity is achieved and documented in results table.
- Marker features are successfully visualized on the 2D MS map without conventional peak picking step.
Limitations
- Method has been demonstrated only on aroma odor and human breath GC–MS case studies; generalization to other sample types or LC–MS workflows requires further validation.
- Image registration and spatial alignment assumptions may fail if retention time or m/z calibration drifts significantly across a batch.
- No changelog or version history provided in repository; reproducibility and software maintenance status uncertain.
Evidence
- [intro] NPFimg processes a two-dimensional MS map (m/z vs retention time) to discriminate analytes and identify and visualize the marker features.: "NPFimg processes a two-dimensional MS map (m/z vs retention time) to discriminate analytes and identify and visualize the marker features."
- [intro] Our approach allows us to comprehensively characterize the signals in MS data without the conventional peak picking process, which suffers from false peak detections.: "Our approach allows us to comprehensively characterize the signals in MS data without the conventional peak picking process, which suffers from false peak detections."
- [intro] Marker identification feasibility is demonstrated in case studies of aroma odor and human breath on GC–MS at parts per billion level: "The feasibility of marker identification is successfully demonstrated in case studies of aroma odor and human breath on gas chromatography–mass spectrometry (GC–MS) even at the parts per billion"
- [intro] NPFimg has lower error rates of signal acquisition and marker identification compared to XCMS: "Comparison with the widely used XCMS shows the excellent reliability of NPFimg, in that it has lower error rates of signal acquisition and marker identification."
- [readme] NPFimg automatically identifies multivariate chemo-/biomarker features by combining image processing and machine learning: "automatically identifies multivariate chemo-/biomarker features of analytes in chromatography–mass spectrometry (MS) data by combining image processing and machine learning"
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.