interference-profile-identification
License: restricted — no clear open-source license detected for the underlying tool; verify licensing before commercial use or redistribution.
Summary
Identify and diagnose highly convoluted elution and ion mobility profiles caused by spectral interferences in IM-MS data, which may compromise the accuracy of downstream signal reconstruction algorithms like saturation repair. This skill is essential for quality control of preprocessed IM-MS data to flag problematic ion signals before accepting computational corrections.
When to use
Apply this skill after running saturation repair or multidimensional smoothing on IM-MS data when you need to validate whether corrected peaks are reliable or whether overlapping coeluting/comobiling ions may have caused incorrect signal reconstruction. Use it particularly when working with complex biological samples (proteomics, metabolomics) where matrix effects and structural isomer coelution are common.
When NOT to use
- Input data is from a simple, well-separated standard or a low-complexity sample where coelution is unlikely.
- Saturation repair was not applied or is not part of the preprocessing pipeline; interference diagnosis is orthogonal to noise filtering alone.
- Data quality is already confirmed via orthogonal reference standards or prior LC-MS/MS validation of the same analytes.
Inputs
- PNNL PreProcessor output logs (text)
- Raw Agilent MassHunter (.d) or UIMF IM-MS data file
- Preprocessed IM-MS data frame with m/z, drift time, retention time, and intensity dimensions
Outputs
- Flagged ion list (m/z, CCS/drift time, retention time ranges with interference markers)
- Diagnostic report identifying ions with convoluted elution/mobility profiles
- Annotated region map (regions where saturation repair may have produced incorrect results)
How to apply
Load preprocessed IM-MS output logs and examine them for warnings flagged during saturation repair execution. Search logs for signals exhibiting convoluted elution/mobility profiles — these are ions with complex, multimodal intensity distributions across retention time and drift time dimensions that may be caused by coeluting species or isomers. Cross-reference flagged m/z, mobility, and retention time ranges against the raw data using the IM-MS Browser or similar visualization tool. If an ion's signal profile shows multiple peaks or asymmetric distortion across the mobility and RT dimensions, and saturation repair was applied to that region, treat the repaired signal with caution and consider manual inspection or exclusion from quantification. The rationale is that saturation repair software assumes unimodal, well-resolved peak shapes; violations of this assumption lead to incorrect peak reconstruction.
Related tools
- PNNL PreProcessor (Generates preprocessed IM-MS data and output logs containing saturation repair warnings and metadata; reads raw .d and UIMF files) — https://github.com/PNNL-Comp-Mass-Spec/PNNL-PreProcessor
- IM-MS Browser (Visualizes and manually inspects ion mobility, retention time, and m/z distributions to confirm convoluted peak profiles flagged by logs)
- Agilent MassHunter (Source instrument software; provides raw .d data files that serve as input for PNNL PreProcessor and can be opened for secondary visualization)
Evaluation signals
- Output logs contain explicit warnings about 'convoluted elution/mobility profiles' for specific m/z and retention time windows; log entries are parsed and flagged ions match independent visual inspection in IM-MS Browser.
- Flagged ions show multimodal or heavily tailed intensity distributions across drift time and retention time dimensions in the raw data; unflagged ions exhibit symmetric, unimodal profiles.
- Saturation repair corrections for flagged regions are validated against a reference standard or orthogonal LC-MS/MS data; corrected peaks diverge from reference values (e.g., >20% intensity error, altered peak centroid).
- Reproducibility check: re-running PNNL PreProcessor on the same raw file with identical settings produces consistent interference flags; flags appear in the same m/z and retention time ranges.
- Quantification sensitivity: quantitative results (peak area, intensity) for flagged vs. unflagged ions differ significantly when saturation repair is toggled on/off; flagged ions show larger divergence, indicating unstable reconstruction.
Limitations
- Saturation repair software may produce incorrect results for ions with highly convoluted elution/mobility profiles caused by interferences, but the tool does not automatically distinguish between true coelution and instrumental artifacts; manual inspection is required.
- The identification depends on log output from PNNL PreProcessor; silent failures or warnings suppressed by user settings will not be captured.
- Interference profiles caused by structural isomers or isobars may be indistinguishable from true coelution without tandem MS or chemical derivatization validation.
- No quantitative threshold for 'convoluted' is defined in the literature; diagnosis relies on qualitative log inspection and visual assessment.
Evidence
- [methods] Saturation repair software may produce incorrect results: "the saturation repair software may produce incorrect results for ions with highly convoluted elution/mobility profiles caused by interferences"
- [other] Verify repair success by checking output logs for warnings: "Verify repair success by checking output logs for warnings about convoluted elution/mobility profiles that may have caused incorrect repairs."
- [other] Multidimensional smoothing and saturation repair algorithm: "Apply multidimensional smoothing and saturation repair algorithm to detect and reconstruct saturated peaks across the m/z, mobility, and retention time dimensions."
- [methods] Smoothing removes artifacts in jagged peaks: "Smoothing removes artifacts in jagged peaks, which are common in low-abundance ions."
- [readme] IM-MS preprocessing pipeline capabilities: "multidimensional smoothing, noise filtering by low intensity threshold and spike removal, saturation repair and metadata export"
1---2name: interference-profile-identification-23description: Use when after running saturation repair or multidimensional smoothing on IM-MS data when you need to validate whether corrected peaks are reliable or whether overlapping coeluting/comobiling ions may have caused incorrect signal reconstruction.4license: CC-BY-4.05---67# interference-profile-identification89> **License: restricted** — no clear open-source license detected for the underlying tool; verify licensing before commercial use or redistribution. <!-- asb-license-banner -->10## Summary1112Identify and diagnose highly convoluted elution and ion mobility profiles caused by spectral interferences in IM-MS data, which may compromise the accuracy of downstream signal reconstruction algorithms like saturation repair. This skill is essential for quality control of preprocessed IM-MS data to flag problematic ion signals before accepting computational corrections.1314## When to use1516Apply this skill after running saturation repair or multidimensional smoothing on IM-MS data when you need to validate whether corrected peaks are reliable or whether overlapping coeluting/comobiling ions may have caused incorrect signal reconstruction. Use it particularly when working with complex biological samples (proteomics, metabolomics) where matrix effects and structural isomer coelution are common.1718## When NOT to use1920- Input data is from a simple, well-separated standard or a low-complexity sample where coelution is unlikely.21- Saturation repair was not applied or is not part of the preprocessing pipeline; interference diagnosis is orthogonal to noise filtering alone.22- Data quality is already confirmed via orthogonal reference standards or prior LC-MS/MS validation of the same analytes.2324## Inputs2526- PNNL PreProcessor output logs (text)27- Raw Agilent MassHunter (.d) or UIMF IM-MS data file28- Preprocessed IM-MS data frame with m/z, drift time, retention time, and intensity dimensions2930## Outputs3132- Flagged ion list (m/z, CCS/drift time, retention time ranges with interference markers)33- Diagnostic report identifying ions with convoluted elution/mobility profiles34- Annotated region map (regions where saturation repair may have produced incorrect results)3536## How to apply3738Load preprocessed IM-MS output logs and examine them for warnings flagged during saturation repair execution. Search logs for signals exhibiting convoluted elution/mobility profiles — these are ions with complex, multimodal intensity distributions across retention time and drift time dimensions that may be caused by coeluting species or isomers. Cross-reference flagged m/z, mobility, and retention time ranges against the raw data using the IM-MS Browser or similar visualization tool. If an ion's signal profile shows multiple peaks or asymmetric distortion across the mobility and RT dimensions, and saturation repair was applied to that region, treat the repaired signal with caution and consider manual inspection or exclusion from quantification. The rationale is that saturation repair software assumes unimodal, well-resolved peak shapes; violations of this assumption lead to incorrect peak reconstruction.3940## Related tools4142- **PNNL PreProcessor** (Generates preprocessed IM-MS data and output logs containing saturation repair warnings and metadata; reads raw .d and UIMF files) — https://github.com/PNNL-Comp-Mass-Spec/PNNL-PreProcessor43- **IM-MS Browser** (Visualizes and manually inspects ion mobility, retention time, and m/z distributions to confirm convoluted peak profiles flagged by logs)44- **Agilent MassHunter** (Source instrument software; provides raw .d data files that serve as input for PNNL PreProcessor and can be opened for secondary visualization)4546## Evaluation signals4748- Output logs contain explicit warnings about 'convoluted elution/mobility profiles' for specific m/z and retention time windows; log entries are parsed and flagged ions match independent visual inspection in IM-MS Browser.49- Flagged ions show multimodal or heavily tailed intensity distributions across drift time and retention time dimensions in the raw data; unflagged ions exhibit symmetric, unimodal profiles.50- Saturation repair corrections for flagged regions are validated against a reference standard or orthogonal LC-MS/MS data; corrected peaks diverge from reference values (e.g., >20% intensity error, altered peak centroid).51- Reproducibility check: re-running PNNL PreProcessor on the same raw file with identical settings produces consistent interference flags; flags appear in the same m/z and retention time ranges.52- Quantification sensitivity: quantitative results (peak area, intensity) for flagged vs. unflagged ions differ significantly when saturation repair is toggled on/off; flagged ions show larger divergence, indicating unstable reconstruction.5354## Limitations5556- Saturation repair software may produce incorrect results for ions with highly convoluted elution/mobility profiles caused by interferences, but the tool does not automatically distinguish between true coelution and instrumental artifacts; manual inspection is required.57- The identification depends on log output from PNNL PreProcessor; silent failures or warnings suppressed by user settings will not be captured.58- Interference profiles caused by structural isomers or isobars may be indistinguishable from true coelution without tandem MS or chemical derivatization validation.59- No quantitative threshold for 'convoluted' is defined in the literature; diagnosis relies on qualitative log inspection and visual assessment.6061## Evidence6263- [methods] Saturation repair software may produce incorrect results: "the saturation repair software may produce incorrect results for ions with highly convoluted elution/mobility profiles caused by interferences"64- [other] Verify repair success by checking output logs for warnings: "Verify repair success by checking output logs for warnings about convoluted elution/mobility profiles that may have caused incorrect repairs."65- [other] Multidimensional smoothing and saturation repair algorithm: "Apply multidimensional smoothing and saturation repair algorithm to detect and reconstruct saturated peaks across the m/z, mobility, and retention time dimensions."66- [methods] Smoothing removes artifacts in jagged peaks: "Smoothing removes artifacts in jagged peaks, which are common in low-abundance ions."67- [readme] IM-MS preprocessing pipeline capabilities: "multidimensional smoothing, noise filtering by low intensity threshold and spike removal, saturation repair and metadata export"
HolobiomicsLab