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
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."
1---2name: coeluting-ion-separation3description: Use 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.4license: CC-BY-4.05---67# coeluting-ion-separation89## Summary1011Spectral 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.1213## When to use1415Apply 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.1617## When NOT to use1819- Input is already a feature table or pre-deconvolved peak list20- GC-MS data contains no overlapping peaks (baseline-resolved chromatography)21- Instrument produces high-resolution separations where co-elution is not a concern2223## Inputs2425- Raw GC-MS data in netCDF format26- Raw GC-MS data in mzML format27- Mass spectrometry data with overlapping chromatographic peaks2829## Outputs3031- Deconvolved peak table (tabular format, one row per component)32- Peak features (retention time, m/z values, intensity per component)33- Individual resolved mass spectra for each co-eluting component3435## How to apply3637Load 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.3839## Related tools4041- **GNPS_GC** (Implements auto-deconvolution algorithm and spectral separation workflow for GC-MS data) — https://github.com/bittremieux/GNPS_GC4243## Evaluation signals4445- Peak count increases after deconvolution compared to raw input (indicates successful component separation)46- Deconvolved peak table schema includes retention time, m/z, and intensity columns with valid numeric values47- Separated mass spectra exhibit internal coherence (m/z ratios consistent with single chemical compounds)48- Retention time ranges of separated components do not exceed instrument resolution limits49- Visual inspection confirms that previously overlapping signals are now resolved into distinct spectral patterns5051## Limitations5253- Deconvolution quality depends on peak overlap severity; heavily overlapped signals may not fully resolve54- Method assumes input data is in valid netCDF or mzML format; malformed files will fail55- No documented changelog or versioning in the repository limits reproducibility tracking across releases56- Spectral coherence validation requires manual expert review for complex or noisy data5758## Evidence5960- [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."61- [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."62- [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."63- [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."64- [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."65- [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."