coeluting-ion-separation
Summary
Spectral deconvolution method that separates co-eluting ions in gas chromatography–mass spectrometry (GC-MS) data to resolve individual mass spectra from overlapping chromatographic peaks. This skill transforms composite signals into distinct component-level features suitable for molecular identification and networking.
When to use
Apply this skill when raw GC-MS data (netCDF or mzML format) exhibits overlapping chromatographic peaks—i.e., when multiple analytes elute at similar retention times and produce composite mass spectra with ambiguous m/z signals. Use it as a preprocessing step before molecular networking, feature extraction, or metabolite annotation to increase peak count and spectral coherence.
When NOT to use
- Input is already a feature table or pre-deconvolved peak list
- GC-MS data contains no overlapping peaks (baseline-resolved chromatography)
- Instrument produces high-resolution separations where co-elution is not a concern
Inputs
- Raw GC-MS data in netCDF format
- Raw GC-MS data in mzML format
- Mass spectrometry data with overlapping chromatographic peaks
Outputs
- Deconvolved peak table (tabular format, one row per component)
- Peak features (retention time, m/z values, intensity per component)
- Individual resolved mass spectra for each co-eluting component
How to apply
Load raw GC-MS data in netCDF or mzML format containing overlapping peaks. Apply a spectral deconvolution algorithm that separates co-eluting ions by resolving individual mass spectra from composite signals. Extract deconvolved peak features (retention time, m/z values, intensity) for each resolved component and generate a peak table with one row per deconvolved component. Validate deconvolution quality by confirming an increase in peak count and verifying spectral coherence of separated components—components should have internally consistent m/z patterns consistent with single analytes.
Related tools
- GNPS_GC (Implements auto-deconvolution algorithm and spectral separation workflow for GC-MS data) — https://github.com/bittremieux/GNPS_GC
Evaluation signals
- Peak count increases after deconvolution compared to raw input (indicates successful component separation)
- Deconvolved peak table schema includes retention time, m/z, and intensity columns with valid numeric values
- Separated mass spectra exhibit internal coherence (m/z ratios consistent with single chemical compounds)
- Retention time ranges of separated components do not exceed instrument resolution limits
- Visual inspection confirms that previously overlapping signals are now resolved into distinct spectral patterns
Limitations
- Deconvolution quality depends on peak overlap severity; heavily overlapped signals may not fully resolve
- Method assumes input data is in valid netCDF or mzML format; malformed files will fail
- No documented changelog or versioning in the repository limits reproducibility tracking across releases
- Spectral coherence validation requires manual expert review for complex or noisy data
Evidence
- [other] Load raw GC-MS data (netCDF or mzML format) containing overlapping chromatographic peaks.: "Load raw GC-MS data (netCDF or mzML format) containing overlapping chromatographic peaks."
- [other] Apply spectral deconvolution algorithm to separate co-eluting ions and resolve individual mass spectra from composite signals.: "Apply spectral deconvolution algorithm to separate co-eluting ions and resolve individual mass spectra from composite signals."
- [other] Extract deconvolved peak features including retention time, m/z values, and intensity for each resolved component.: "Extract deconvolved peak features including retention time, m/z values, and intensity for each resolved component."
- [other] Generate output peak table in tabular format with one row per deconvolved component, including intensity, m/z, and retention time columns.: "Generate output peak table in tabular format with one row per deconvolved component, including intensity, m/z, and retention time columns."
- [other] Validate deconvolution quality by confirming peak count increase and verifying spectral coherence of separated components.: "Validate deconvolution quality by confirming peak count increase and verifying spectral coherence of separated components."
- [other] Auto-deconvolution as a processing method for gas chromatography–mass spectrometry data, implemented in the GNPS_GC companion repository.: "auto-deconvolution as a processing method for gas chromatography–mass spectrometry data, implemented in the GNPS_GC companion repository."
