chromatographic-peak-detection-and-segmentation
License: noncommercial — confirm your use is a permitted (noncommercial) purpose before applying; commercial use requires a separate license (see metadata.tool_license).
Summary
Nontargeted peak detection and segmentation identifies and delineates chromatographic peaks across the full retention time range in raw LC-MS data (mzML or vendor formats) to extract precise peak boundaries and characteristic metadata. This is a foundational step in untargeted metabolomics workflows for converting raw instrument output into structured feature tables.
When to use
Apply this skill when you have raw LC-MS data (mzML or vendor format) and need to discover and characterize all chromatographic features present, without prior knowledge of target analytes. Use it as the initial feature extraction step before quality evaluation, annotation, or statistical analysis in untargeted metabolomics studies.
When NOT to use
- Input is already a processed feature table or peak list; peak detection has already been performed.
- Targeted analysis of known analytes where peak lists are predefined; use targeted extraction instead.
- Data from alternative analytical methods (e.g., GC-MS, ion mobility) not explicitly supported by the tool.
Inputs
- raw LC-MS data (mzML format)
- raw LC-MS data (vendor format)
Outputs
- feature table (CSV format)
- feature table (feather format)
- detected peaks with m/z, retention time, intensity, peak width, and quality metrics
How to apply
Load raw LC-MS data into MassCube and invoke the nontargeted peak detection algorithm to scan across the full retention time range and identify all significant peaks. The algorithm performs peak segmentation to define precise boundaries for each detected peak. For each peak, extract and record characteristic metadata: m/z value, retention time, intensity, and peak width. Export the resulting peak list as a structured feature table (CSV or feather format) containing all detected peaks with their associated quality metrics. Validate output by inspecting peak count, retention time range coverage, and intensity distribution to confirm detection sensitivity and specificity.
Related tools
- masscube (integrated Python package that performs nontargeted peak detection and segmentation on LC-MS data, defines peak boundaries, and exports feature tables) — https://github.com/huaxuyu/masscube/
- Python (programming language in which MassCube is implemented and executed)
Examples
from masscube import MassCube; mc = MassCube(); peaks = mc.peak_detection(raw_data_path='sample.mzML'); peaks.to_csv('detected_peaks.csv')
Evaluation signals
- Feature table contains expected number of peaks with realistic m/z range (e.g., 50–2000 m/z for metabolomics) and retention time span matching the LC method.
- Peak width values are consistent with typical chromatographic peak shapes (e.g., 0.01–1 min for UHPLC).
- Intensity values show reasonable distribution; no unexpectedly saturated or near-zero peaks across features.
- Peak segmentation boundaries do not overlap; each detected peak occupies a discrete retention time window.
- Quality metrics reported in feature table (if present) indicate confidence in detection and segmentation for each peak.
Limitations
- No changelog provided in repository documentation; version tracking and backward compatibility are not explicitly documented.
- Performance on data with high background noise, co-eluting peaks, or unusual chromatographic profiles is not discussed.
- Nontargeted approach may detect instrument noise or artifacts; post-detection quality filtering is recommended.
Evidence
- [intro] Highly accurate nontargeted peak detection and segmentation: "Highly accurate nontargeted peak detection and segmentation."
- [readme] masscube is an integrated Python package for LC-MS data processing: "masscube is an integrated Python package for liquid chromatography-mass spectrometry (LC-MS) data processing."
- [other] Peak detection workflow across full retention time range: "Apply nontargeted peak detection algorithm to identify chromatographic peaks across the full retention time range."
- [other] Peak segmentation defines boundaries and extracts characteristics: "Perform peak segmentation to define precise peak boundaries and extract peak characteristics (m/z, retention time, intensity, peak width)."
- [other] Export feature table in standard formats: "Generate and export feature table in tabular format (CSV or feather) containing detected peaks with their metadata and quality metrics."
1---2name: chromatographic-peak-detection-and-segmentation-23description: Use when you have raw LC-MS data (mzML or vendor format) and need to discover and characterize all chromatographic features present, without prior knowledge of target analytes.4license: CC-BY-4.05---67# chromatographic-peak-detection-and-segmentation89> **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 -->10## Summary1112Nontargeted peak detection and segmentation identifies and delineates chromatographic peaks across the full retention time range in raw LC-MS data (mzML or vendor formats) to extract precise peak boundaries and characteristic metadata. This is a foundational step in untargeted metabolomics workflows for converting raw instrument output into structured feature tables.1314## When to use1516Apply this skill when you have raw LC-MS data (mzML or vendor format) and need to discover and characterize all chromatographic features present, without prior knowledge of target analytes. Use it as the initial feature extraction step before quality evaluation, annotation, or statistical analysis in untargeted metabolomics studies.1718## When NOT to use1920- Input is already a processed feature table or peak list; peak detection has already been performed.21- Targeted analysis of known analytes where peak lists are predefined; use targeted extraction instead.22- Data from alternative analytical methods (e.g., GC-MS, ion mobility) not explicitly supported by the tool.2324## Inputs2526- raw LC-MS data (mzML format)27- raw LC-MS data (vendor format)2829## Outputs3031- feature table (CSV format)32- feature table (feather format)33- detected peaks with m/z, retention time, intensity, peak width, and quality metrics3435## How to apply3637Load raw LC-MS data into MassCube and invoke the nontargeted peak detection algorithm to scan across the full retention time range and identify all significant peaks. The algorithm performs peak segmentation to define precise boundaries for each detected peak. For each peak, extract and record characteristic metadata: m/z value, retention time, intensity, and peak width. Export the resulting peak list as a structured feature table (CSV or feather format) containing all detected peaks with their associated quality metrics. Validate output by inspecting peak count, retention time range coverage, and intensity distribution to confirm detection sensitivity and specificity.3839## Related tools4041- **masscube** (integrated Python package that performs nontargeted peak detection and segmentation on LC-MS data, defines peak boundaries, and exports feature tables) — https://github.com/huaxuyu/masscube/42- **Python** (programming language in which MassCube is implemented and executed)4344## Examples4546```47from masscube import MassCube; mc = MassCube(); peaks = mc.peak_detection(raw_data_path='sample.mzML'); peaks.to_csv('detected_peaks.csv')48```4950## Evaluation signals5152- Feature table contains expected number of peaks with realistic m/z range (e.g., 50–2000 m/z for metabolomics) and retention time span matching the LC method.53- Peak width values are consistent with typical chromatographic peak shapes (e.g., 0.01–1 min for UHPLC).54- Intensity values show reasonable distribution; no unexpectedly saturated or near-zero peaks across features.55- Peak segmentation boundaries do not overlap; each detected peak occupies a discrete retention time window.56- Quality metrics reported in feature table (if present) indicate confidence in detection and segmentation for each peak.5758## Limitations5960- No changelog provided in repository documentation; version tracking and backward compatibility are not explicitly documented.61- Performance on data with high background noise, co-eluting peaks, or unusual chromatographic profiles is not discussed.62- Nontargeted approach may detect instrument noise or artifacts; post-detection quality filtering is recommended.6364## Evidence6566- [intro] Highly accurate nontargeted peak detection and segmentation: "Highly accurate nontargeted peak detection and segmentation."67- [readme] masscube is an integrated Python package for LC-MS data processing: "masscube is an integrated Python package for liquid chromatography-mass spectrometry (LC-MS) data processing."68- [other] Peak detection workflow across full retention time range: "Apply nontargeted peak detection algorithm to identify chromatographic peaks across the full retention time range."69- [other] Peak segmentation defines boundaries and extracts characteristics: "Perform peak segmentation to define precise peak boundaries and extract peak characteristics (m/z, retention time, intensity, peak width)."70- [other] Export feature table in standard formats: "Generate and export feature table in tabular format (CSV or feather) containing detected peaks with their metadata and quality metrics."
HolobiomicsLab 