Multiplexed spectrum decomposition
Curated, evidence-grounded skill and software-tool collections for scientific AI agents, generated by the AgenticScienceBuilder
npx -y skills add HolobiomicsLab/asb-skill-collections --skill multiplexed-spectrum-decompositionAssembled 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 author says it does
Copied from the file, not written here
Use when you have SWATH-MS data (mzML or vendor binary format) where precursor isolation windows intentionally capture multiple co-eluting compounds, resulting in multiplexed MS/MS spectra that contain mixed fragment ion peaks from unknown metabolites.
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.0 KB, as published. Nobody here has run it
multiplexed-spectrum-decomposition
License: noncommercial — confirm your use is a permitted (noncommercial) purpose before applying; commercial use requires a separate license (see
metadata.tool_license). <!-- asb-license-banner -->
Summary
Algorithmic separation of overlapping MS/MS spectra acquired under SWATH-MS multiplexing into individual component spectra to enable untargeted metabolite identification. This skill is essential when precursor ion windows capture multiple co-eluting analytes whose fragment spectra overlap in m/z and intensity space.
When to use
You have SWATH-MS data (mzML or vendor binary format) where precursor isolation windows intentionally capture multiple co-eluting compounds, resulting in multiplexed MS/MS spectra that contain mixed fragment ion peaks from unknown metabolites. Apply this skill before spectral library matching when standard deconvolution approaches fail due to the complexity and number of overlapping signals.
When NOT to use
- Input data are already separated single-precursor MS/MS spectra (e.g., from targeted MRM or DDA with narrow isolation windows); deconvolution is unnecessary.
- SWATH-MS precursor windows are too wide or retention time binning is too coarse to meaningfully group co-eluting analytes; data quality is insufficient for reliable decomposition.
- The application requires real-time or streaming analysis; DecoMetDIA requires full batch processing of raw data files.
Inputs
- SWATH-MS raw data files (mzML format or vendor-specific binary)
- Precursor ion window definitions (m/z ranges and retention time windows)
- Multiplexed MS/MS spectra (mixed fragment ion peaks from co-eluting analytes)
Outputs
- Deconvoluted MS/MS spectra (individual component spectra, one per analyte)
- Annotated spectral data (MGF or mzTab format with precursor m/z, retention time, intensity)
- Spectral quality metrics (peak counts, intensity distributions, mass accuracy)
How to apply
Load SWATH-MS raw data into DecoMetDIA and apply precursor ion isolation and retention time windowing to group co-eluting fragment spectra. The tool then performs multiplexed spectrum decomposition—an algorithm that separates overlapping MS/MS spectra into individual component spectra by decomposing the mixed signal into constituent peaks and their precursor-fragment relationships. After deconvolution, validate the separated spectra by checking peak counts, intensity distributions, and mass accuracy against known standards or in silico predictions. Export deconvoluted spectra with precursor m/z, retention time, and intensity annotations in MGF or mzTab format for downstream metabolite identification.
Related tools
- DecoMetDIA (R package implementing multiplexed spectrum decomposition algorithm with Rcpp components for SWATH-MS data processing) — https://github.com/ZhuMSLab/DecoMetDIA
Examples
devtools::install_github("ZhuMSLab/DecoMetDIA"); library(DecoMetDIA); result <- decoMetDIA(rawfile="sample.mzML", precursor_windows=list(mz_range=c(100, 1200), rt_bin=30))
Evaluation signals
- Deconvoluted spectra exhibit appropriate peak counts and intensity distributions consistent with single-analyte MS/MS spectra, not residual multiplex patterns.
- Mass accuracy of fragment ions in separated spectra matches instrument calibration tolerances (typically <5 ppm for high-resolution instruments).
- Precursor m/z and retention time annotations are preserved and consistent with input isolation windows and chromatographic alignment.
- Separated spectra can be matched to metabolite standards or database entries with cosine similarity or other spectral similarity metrics above acceptance thresholds.
- Signal-to-noise ratio and peak intensity distributions improve after deconvolution compared to raw multiplexed spectra, indicating successful decomposition.
Limitations
- Deconvolution accuracy depends on the number and degree of overlap of co-eluting analytes; highly overlapped spectra may yield ambiguous or incomplete decomposition.
- The algorithm requires sufficient chromatographic resolution and retention time precision to correctly group spectra into windows; poor chromatography increases decomposition errors.
- DecoMetDIA requires compilation with Rcpp on installation; Windows users must have RTools installed, and compilation may fail on systems lacking appropriate build tools.
- The tool is designed for untargeted metabolomics; applicability to other MS/MS multiplexing schemes (e.g., data-independent acquisition with different window strategies) is not addressed in the publication.
Evidence
- [readme] DecoMetDIA was developed to process SWATH-MS based data for metabolomics: "DecoMetDIA was developed to process SWATH-MS based data for metabolomics."
- [other] Deconvolution workflow and algorithm description: "Perform spectral deconvolution using DecoMetDIA's multiplexed spectrum decomposition algorithm to separate overlapping MS/MS spectra into individual component spectra."
- [other] Input and output data formats: "Load SWATH-MS raw data files (mzML or vendor format) into DecoMetDIA. ... Export deconvoluted spectra with associated precursor m/z, retention time, and intensity annotations in MGF or mzTab format."
- [other] Validation criteria for deconvoluted spectra: "Validate deconvoluted spectra quality by checking for appropriate peak counts, intensity distributions, and mass accuracy."
- [readme] Installation and technical requirements: "DecoMetDIA was developed as an R package with Rcpp code. Compiling is needed when installing. On Windows OS, RTools should be installed first."