untargeted-metabolomics-marker-identification
License: restricted — no clear open-source license detected for the underlying tool; verify licensing before commercial use or redistribution.
Summary
Automated identification of multivariate chemo-/biomarker features in untargeted metabolomics data by processing two-dimensional chromatography–mass spectrometry maps (m/z vs retention time) using image processing and machine learning, without conventional peak picking. This skill is particularly suited for human breath GC–MS analysis and other low-abundance analyte detection scenarios where false peak detection is a concern.
When to use
When you have untargeted GC–MS or LC–MS data in the form of a two-dimensional m/z vs retention time map and need to identify marker features without conventional peak picking. Specifically applicable when: (1) you are analyzing human breath or aroma samples at parts per billion sensitivity levels, (2) you want to avoid false peak detections inherent in conventional peak picking, (3) you need multivariate marker discrimination rather than simple peak lists, and (4) you seek automated rather than manual feature annotation.
When NOT to use
- Input data are already peak-picked, aligned, and formatted as a feature abundance table; use this skill on raw 2D m/z vs retention time maps, not pre-processed feature matrices.
- You require targeted metabolomics with predefined compound lists and MS/MS fragmentation matching; NPFimg is designed for untargeted discovery.
- Your MS instrument produces very high noise or baseline artifacts that are inseparable from signal by image processing alone; preprocessing or instrument optimization may be needed first.
Inputs
- Two-dimensional MS map (m/z vs retention time) from GC–MS or LC–MS acquisition
- Raw chromatography–mass spectrometry data in a format compatible with NPFimg import (e.g., NetCDF or vendor-neutral formats)
Outputs
- Structured table of marker feature predictions with m/z values, retention times, and feature scores
- Visualization of identified marker features overlaid on the m/z–retention time space
- Discriminated analyte feature set suitable for downstream metabolomics or chemometrics analysis
How to apply
Load the two-dimensional MS map (m/z vs retention time) from your chromatography–MS dataset into NPFimg. Apply the NPFimg image processing and machine learning pipeline, which treats the MS map as an image and applies automated detection algorithms to discriminate analytes and identify marker features across the m/z–retention time space. The method avoids conventional peak picking by processing the full 2D structure, reducing false positives. Automated detection yields marker features with associated m/z values, retention times, and feature scores. Export predictions to a structured table and visualize identified marker features on the m/z–retention time space to confirm spatial coherence and biological plausibility. Comparison with XCMS or other tools can validate reliability, particularly for signal acquisition and marker identification error rates.
Related tools
- NPFimg (Core image processing and machine learning pipeline for automated marker feature identification from 2D m/z vs retention time maps) — https://github.com/poomcj/NPFimg
- XCMS (Comparison benchmark tool for conventional peak picking and marker identification; used to validate NPFimg's lower error rates)
Evaluation signals
- Marker features identified by NPFimg exhibit lower false positive rates and signal acquisition errors compared to XCMS on the same dataset.
- Identified m/z values and retention times cluster spatially on the 2D map without fragmentation across the time or m/z axis, indicating genuine analyte signals rather than noise artifacts.
- Exported feature scores correlate with known analyte concentrations or show expected abundance patterns across sample groups (e.g., human breath vs. blank).
- Visualization of marker features on the m/z–retention time map shows coherent, localized 2D regions rather than scattered isolated points.
- Downstream statistical or classification models using NPFimg-identified features show comparable or improved performance relative to conventional peak-picked features.
Limitations
- Method feasibility is demonstrated primarily on GC–MS case studies of aroma odor and human breath; generalization to other sample matrices or LC–MS platforms requires additional validation.
- Effectiveness depends on data quality; very high baseline noise, instrumental drift, or poor peak resolution may compromise feature discrimination.
- Image processing heuristics (e.g., morphological operations, threshold parameters) are tuned for the case studies shown; transfer to different instrument types, columns, or MS scan rates may require parameter retuning.
- Repository documentation is minimal; the full methodological details are available only in the published article, which may hinder reproducibility or extension without access to the paper.
Evidence
- [intro] NPFimg automatically identifies multivariate chemo-/biomarker features in chromatography–mass spectrometry data by combining image processing and machine learning: "We present a method named NPFimg, which automatically identifies multivariate chemo-/biomarker features of analytes in chromatography–mass spectrometry (MS) data by combining image processing and"
- [intro] NPFimg processes a 2D m/z vs retention time map to discriminate analytes and identify marker features without conventional peak picking: "NPFimg processes a two-dimensional MS map (m/z vs retention time) to discriminate analytes and identify and visualize the marker features. Our approach allows us to comprehensively characterize the"
- [intro] Marker identification is demonstrated in human breath GC–MS case studies at parts per billion level sensitivity: "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 shows lower error rates than XCMS in signal acquisition and marker identification: "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."
- [intro] NPFimg is applicable to untargeted metabolomics of human breath and diverse metabolomics/chemometrics using GC–MS and LC–MS: "In addition, we show the potential applicability of NPFimg to the untargeted metabolomics of human breath. While this study shows the limited applications, NPFimg is potentially applicable to data"
- [other] Workflow: load 2D MS map, apply image processing and machine learning pipeline, identify and export marker features with m/z, retention time, and scores: "Load the two-dimensional MS map (m/z vs retention time) from the breath GC–MS dataset into NPFimg. Apply NPFimg image processing and machine learning pipeline to process the MS map and discriminate"
1---2name: untargeted-metabolomics-marker-identification-23description: Use when when you have untargeted GC–MS or LC–MS data in the form of a two-dimensional m/z vs retention time map and need to identify marker features without conventional peak picking.4license: CC-BY-4.05---67# untargeted-metabolomics-marker-identification89> **License: restricted** — no clear open-source license detected for the underlying tool; verify licensing before commercial use or redistribution. <!-- asb-license-banner -->10## Summary1112Automated identification of multivariate chemo-/biomarker features in untargeted metabolomics data by processing two-dimensional chromatography–mass spectrometry maps (m/z vs retention time) using image processing and machine learning, without conventional peak picking. This skill is particularly suited for human breath GC–MS analysis and other low-abundance analyte detection scenarios where false peak detection is a concern.1314## When to use1516When you have untargeted GC–MS or LC–MS data in the form of a two-dimensional m/z vs retention time map and need to identify marker features without conventional peak picking. Specifically applicable when: (1) you are analyzing human breath or aroma samples at parts per billion sensitivity levels, (2) you want to avoid false peak detections inherent in conventional peak picking, (3) you need multivariate marker discrimination rather than simple peak lists, and (4) you seek automated rather than manual feature annotation.1718## When NOT to use1920- Input data are already peak-picked, aligned, and formatted as a feature abundance table; use this skill on raw 2D m/z vs retention time maps, not pre-processed feature matrices.21- You require targeted metabolomics with predefined compound lists and MS/MS fragmentation matching; NPFimg is designed for untargeted discovery.22- Your MS instrument produces very high noise or baseline artifacts that are inseparable from signal by image processing alone; preprocessing or instrument optimization may be needed first.2324## Inputs2526- Two-dimensional MS map (m/z vs retention time) from GC–MS or LC–MS acquisition27- Raw chromatography–mass spectrometry data in a format compatible with NPFimg import (e.g., NetCDF or vendor-neutral formats)2829## Outputs3031- Structured table of marker feature predictions with m/z values, retention times, and feature scores32- Visualization of identified marker features overlaid on the m/z–retention time space33- Discriminated analyte feature set suitable for downstream metabolomics or chemometrics analysis3435## How to apply3637Load the two-dimensional MS map (m/z vs retention time) from your chromatography–MS dataset into NPFimg. Apply the NPFimg image processing and machine learning pipeline, which treats the MS map as an image and applies automated detection algorithms to discriminate analytes and identify marker features across the m/z–retention time space. The method avoids conventional peak picking by processing the full 2D structure, reducing false positives. Automated detection yields marker features with associated m/z values, retention times, and feature scores. Export predictions to a structured table and visualize identified marker features on the m/z–retention time space to confirm spatial coherence and biological plausibility. Comparison with XCMS or other tools can validate reliability, particularly for signal acquisition and marker identification error rates.3839## Related tools4041- **NPFimg** (Core image processing and machine learning pipeline for automated marker feature identification from 2D m/z vs retention time maps) — https://github.com/poomcj/NPFimg42- **XCMS** (Comparison benchmark tool for conventional peak picking and marker identification; used to validate NPFimg's lower error rates)4344## Evaluation signals4546- Marker features identified by NPFimg exhibit lower false positive rates and signal acquisition errors compared to XCMS on the same dataset.47- Identified m/z values and retention times cluster spatially on the 2D map without fragmentation across the time or m/z axis, indicating genuine analyte signals rather than noise artifacts.48- Exported feature scores correlate with known analyte concentrations or show expected abundance patterns across sample groups (e.g., human breath vs. blank).49- Visualization of marker features on the m/z–retention time map shows coherent, localized 2D regions rather than scattered isolated points.50- Downstream statistical or classification models using NPFimg-identified features show comparable or improved performance relative to conventional peak-picked features.5152## Limitations5354- Method feasibility is demonstrated primarily on GC–MS case studies of aroma odor and human breath; generalization to other sample matrices or LC–MS platforms requires additional validation.55- Effectiveness depends on data quality; very high baseline noise, instrumental drift, or poor peak resolution may compromise feature discrimination.56- Image processing heuristics (e.g., morphological operations, threshold parameters) are tuned for the case studies shown; transfer to different instrument types, columns, or MS scan rates may require parameter retuning.57- Repository documentation is minimal; the full methodological details are available only in the published article, which may hinder reproducibility or extension without access to the paper.5859## Evidence6061- [intro] NPFimg automatically identifies multivariate chemo-/biomarker features in chromatography–mass spectrometry data by combining image processing and machine learning: "We present a method named NPFimg, which automatically identifies multivariate chemo-/biomarker features of analytes in chromatography–mass spectrometry (MS) data by combining image processing and"62- [intro] NPFimg processes a 2D m/z vs retention time map to discriminate analytes and identify marker features without conventional peak picking: "NPFimg processes a two-dimensional MS map (m/z vs retention time) to discriminate analytes and identify and visualize the marker features. Our approach allows us to comprehensively characterize the"63- [intro] Marker identification is demonstrated in human breath GC–MS case studies at parts per billion level sensitivity: "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"64- [intro] NPFimg shows lower error rates than XCMS in signal acquisition and marker identification: "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."65- [intro] NPFimg is applicable to untargeted metabolomics of human breath and diverse metabolomics/chemometrics using GC–MS and LC–MS: "In addition, we show the potential applicability of NPFimg to the untargeted metabolomics of human breath. While this study shows the limited applications, NPFimg is potentially applicable to data"66- [other] Workflow: load 2D MS map, apply image processing and machine learning pipeline, identify and export marker features with m/z, retention time, and scores: "Load the two-dimensional MS map (m/z vs retention time) from the breath GC–MS dataset into NPFimg. Apply NPFimg image processing and machine learning pipeline to process the MS map and discriminate"
HolobiomicsLab 