mass-spectrometry-intensity-drift-correction
Summary
Corrects systematic intensity drifts that accumulate during mass spectrometry runs using calibration-aware statistical methods. This skill ensures accurate quantification of targeted analytes by normalizing feature intensities across the sample sequence.
When to use
Apply this skill when MS quantification data exhibits intensity drift—a systematic decline or variation in detector response across the run sequence. Intensity drift is particularly common in long measurement sessions and compromises the accuracy of feature-by-sample intensity matrices. Trigger conditions include: (1) visual inspection of raw MS chromatograms or intensity profiles showing temporal degradation, (2) calibration curve residuals that increase systematically with run position, or (3) quantified features with coefficient-of-variation that correlates with sample injection order.
When NOT to use
- Input is already a pre-normalized or drift-corrected feature table from an integrated MS software pipeline; applying additional correction may introduce over-normalization artifacts.
- Measurement contains fewer than 3 calibration points per drift-correction block; statistical models require sufficient calibration density to estimate drift reliably.
- Non-targeted or untargeted MS data without external calibration; QuantyFey is designed for external-calibration workflows and cannot correct drift without known-concentration reference standards.
Inputs
- Raw MS quantification table (feature-by-sample intensity matrix)
- Feature identifiers (compound names or mass-to-charge ratios)
- Sample metadata (injection order, sample type, calibration status)
- Calibration sample intensities and known concentrations
- Internal standard intensity data (if using IS correction)
Outputs
- Drift-corrected intensity table (feature-by-sample matrix)
- Preserved feature identifiers and sample metadata
- Regression model parameters (linear or quadratic coefficients)
- Correction factor visualization (optional: intensity drift profile plots)
How to apply
Load the raw MS quantification table (feature-by-sample intensity matrix with preserved feature identifiers and sample metadata) into QuantyFey. Select one of four correction strategies based on study design: Internal Standard (IS) correction if IS compounds were co-injected; Drift Correction using statistical models for parametric estimation; Custom Bracketing Quantification if calibration samples were distributed at predefined blocks in the sequence; or Weighted Bracketing if calibration curves should be weighted by sample position between calibration runs. For automated selection, use the Automatic Optimization Module to choose between linear or quadratic regression models and appropriate standard levels. Export the drift-corrected intensity table, verifying that feature identifiers and sample metadata are preserved and that intensity ranges remain plausible post-correction.
Related tools
Evaluation signals
- Corrected feature intensities no longer show statistically significant correlation with sample injection order (Spearman or Pearson r → 0; p > 0.05).
- Residuals of the fitted regression model (linear or quadratic) are randomly distributed around zero with no systematic trend across the run sequence.
- Coefficient-of-variation (CV) for replicate samples injected at different positions in the sequence decreases after correction (e.g., CV < 15% for targeted quantification).
- Feature identifiers, sample metadata, and intensity ranges are preserved in the corrected output table; no spurious negative values or out-of-range intensities post-correction.
- When available, quantified concentrations computed from drift-corrected intensities match independently verified reference values within expected analytical error (e.g., ±20% relative error).
Limitations
- QuantyFey standalone version is compatible with Windows operating systems only; Apptainer version for Linux is available but more complex to configure; macOS users should launch via R/RStudio directly.
- Correction strategies assume that calibration samples are representative of analyte behavior across the run; if instrumental conditions shift non-linearly or analyte ionization efficiency changes unpredictably, even quadratic models may fail.
- Automatic model optimization selects between linear and quadratic regression but does not account for segmented or piecewise drift patterns; manual intervention via Interactive Regression Model Optimization is required for complex drift profiles.
- No changelog documented in the repository; version tracking and backward-compatibility guarantees are not explicit.
Evidence
- [readme] QuantyFey is a Shiny application for the visualization, analysis, and quantification of mass spectrometry (MS) data: "QuantyFey is a Shiny application for the visualization, analysis, and quantification of mass spectrometry (MS) data"
- [readme] It is specifically designed to address intensity drifts in datasets, offering multiple correction strategies: "It is specifically designed to address intensity drifts in datasets, offering multiple correction strategies to ensure accurate quantification"
- [other] Load the raw MS quantification table into QuantyFey, select and apply drift-correction strategies, export the corrected table: "Load the raw MS quantification table (feature-by-sample intensity matrix) into QuantyFey. 2. Select and apply one of the available drift-correction strategies to normalize intensities across the run"
- [readme] QuantyFey provides Internal Standard (IS) correction, Drift Correction using statistical models, Custom Bracketing Quantification, and Weighted Bracketing: "commonly applied drift correction methods: Internal Standard (IS) correction, Drift Correction using statistical models, Custom Bracketing Quantification, Weighted Bracketing Weighting of calibration"
- [readme] Automatic Optimization Module selects between linear or quadratic regression models and appropriate standards: "Automatic Optimization Module - automatic selection of linear or quadratic regression model, and selection of appropriate standards"
- [readme] QuantyFey is compatible with Windows operating systems only: "QuantyFey is compatible with Windows operating systems only"
- [readme] The standalone version only works on Windows systems and the Apptainer version is recommended for Linux: "The standalone version only works on Windows systems. The apptainer version is recommanded for running on Linux systems"
1---2name: mass-spectrometry-intensity-drift-correction3description: Use when mS quantification data exhibits intensity drift—a systematic decline or variation in detector response across the run sequence. Intensity drift is particularly common in long measurement sessions and compromises the accuracy of feature-by-sample intensity matrices.4license: CC-BY-4.05---67# mass-spectrometry-intensity-drift-correction89## Summary1011Corrects systematic intensity drifts that accumulate during mass spectrometry runs using calibration-aware statistical methods. This skill ensures accurate quantification of targeted analytes by normalizing feature intensities across the sample sequence.1213## When to use1415Apply this skill when MS quantification data exhibits intensity drift—a systematic decline or variation in detector response across the run sequence. Intensity drift is particularly common in long measurement sessions and compromises the accuracy of feature-by-sample intensity matrices. Trigger conditions include: (1) visual inspection of raw MS chromatograms or intensity profiles showing temporal degradation, (2) calibration curve residuals that increase systematically with run position, or (3) quantified features with coefficient-of-variation that correlates with sample injection order.1617## When NOT to use1819- Input is already a pre-normalized or drift-corrected feature table from an integrated MS software pipeline; applying additional correction may introduce over-normalization artifacts.20- Measurement contains fewer than 3 calibration points per drift-correction block; statistical models require sufficient calibration density to estimate drift reliably.21- Non-targeted or untargeted MS data without external calibration; QuantyFey is designed for external-calibration workflows and cannot correct drift without known-concentration reference standards.2223## Inputs2425- Raw MS quantification table (feature-by-sample intensity matrix)26- Feature identifiers (compound names or mass-to-charge ratios)27- Sample metadata (injection order, sample type, calibration status)28- Calibration sample intensities and known concentrations29- Internal standard intensity data (if using IS correction)3031## Outputs3233- Drift-corrected intensity table (feature-by-sample matrix)34- Preserved feature identifiers and sample metadata35- Regression model parameters (linear or quadratic coefficients)36- Correction factor visualization (optional: intensity drift profile plots)3738## How to apply3940Load the raw MS quantification table (feature-by-sample intensity matrix with preserved feature identifiers and sample metadata) into QuantyFey. Select one of four correction strategies based on study design: Internal Standard (IS) correction if IS compounds were co-injected; Drift Correction using statistical models for parametric estimation; Custom Bracketing Quantification if calibration samples were distributed at predefined blocks in the sequence; or Weighted Bracketing if calibration curves should be weighted by sample position between calibration runs. For automated selection, use the Automatic Optimization Module to choose between linear or quadratic regression models and appropriate standard levels. Export the drift-corrected intensity table, verifying that feature identifiers and sample metadata are preserved and that intensity ranges remain plausible post-correction.4142## Related tools4344- **QuantyFey** (Interactive Shiny application for drift-correction strategy selection, model optimization, and export of corrected quantification tables) — https://github.com/CDLMarkus/QuantyFey4546## Evaluation signals4748- Corrected feature intensities no longer show statistically significant correlation with sample injection order (Spearman or Pearson r → 0; p > 0.05).49- Residuals of the fitted regression model (linear or quadratic) are randomly distributed around zero with no systematic trend across the run sequence.50- Coefficient-of-variation (CV) for replicate samples injected at different positions in the sequence decreases after correction (e.g., CV < 15% for targeted quantification).51- Feature identifiers, sample metadata, and intensity ranges are preserved in the corrected output table; no spurious negative values or out-of-range intensities post-correction.52- When available, quantified concentrations computed from drift-corrected intensities match independently verified reference values within expected analytical error (e.g., ±20% relative error).5354## Limitations5556- QuantyFey standalone version is compatible with Windows operating systems only; Apptainer version for Linux is available but more complex to configure; macOS users should launch via R/RStudio directly.57- Correction strategies assume that calibration samples are representative of analyte behavior across the run; if instrumental conditions shift non-linearly or analyte ionization efficiency changes unpredictably, even quadratic models may fail.58- Automatic model optimization selects between linear and quadratic regression but does not account for segmented or piecewise drift patterns; manual intervention via Interactive Regression Model Optimization is required for complex drift profiles.59- No changelog documented in the repository; version tracking and backward-compatibility guarantees are not explicit.6061## Evidence6263- [readme] QuantyFey is a Shiny application for the visualization, analysis, and quantification of mass spectrometry (MS) data: "QuantyFey is a Shiny application for the visualization, analysis, and quantification of mass spectrometry (MS) data"64- [readme] It is specifically designed to address intensity drifts in datasets, offering multiple correction strategies: "It is specifically designed to address intensity drifts in datasets, offering multiple correction strategies to ensure accurate quantification"65- [other] Load the raw MS quantification table into QuantyFey, select and apply drift-correction strategies, export the corrected table: "Load the raw MS quantification table (feature-by-sample intensity matrix) into QuantyFey. 2. Select and apply one of the available drift-correction strategies to normalize intensities across the run"66- [readme] QuantyFey provides Internal Standard (IS) correction, Drift Correction using statistical models, Custom Bracketing Quantification, and Weighted Bracketing: "commonly applied drift correction methods: Internal Standard (IS) correction, Drift Correction using statistical models, Custom Bracketing Quantification, Weighted Bracketing Weighting of calibration"67- [readme] Automatic Optimization Module selects between linear or quadratic regression models and appropriate standards: "Automatic Optimization Module - automatic selection of linear or quadratic regression model, and selection of appropriate standards"68- [readme] QuantyFey is compatible with Windows operating systems only: "QuantyFey is compatible with Windows operating systems only"69- [readme] The standalone version only works on Windows systems and the Apptainer version is recommended for Linux: "The standalone version only works on Windows systems. The apptainer version is recommanded for running on Linux systems"
