stable-isotope-probing-abundance-modeling
Summary
Compute and match observed precursor isotope peaks to theoretical isotopic patterns for natural-abundance or enriched peptides, accounting for stable isotope incorporation probability and charge state. This skill enables quantitative SIP abundance assignment for isotope-labeled peptide precursors within specified m/z isolation windows.
When to use
You have a high-resolution mass spectrum (FT scan) containing a peptide precursor at known charge state with known or suspected stable isotope labeling (e.g. ¹³C, ¹⁵N), a defined m/z isolation window (center and width), and you need to discriminate observed isotope peaks from noise and assign SIP abundances for each matched peak. This is essential when validating SIP-labeled peptide identifications or when manually inspecting PSMs where isotope pattern matching is ambiguous.
When NOT to use
- Precursor m/z or charge state is unknown or highly uncertain; the model will produce spurious matches outside the intended m/z region.
- Isolation window is too narrow relative to peak width, resulting in truncated isotope envelopes and unreliable SIP abundance estimates.
- Input spectrum is unprocessed or contains excessive noise without baseline subtraction; matching will fail or produce false positives.
Inputs
- High-resolution mass spectrum scan (FT1 or Raxport FT2 format, read via mzR)
- Peptide sequence (string, e.g. 'HSQVFSTAEDNQSAVTIHVLQGER')
- Charge state (integer, e.g. +2, +3)
- Isotope atom type (e.g. 'C13', 'N15')
- Incorporation probability (float between 0 and 1)
- Isolation window center m/z (float, e.g. 886.65)
- Isolation window width (float, e.g. 4.0)
Outputs
- ExpectedPrecursorIons table with columns: m/z, intensity, charge, matchedIndices, SIPabundances
- Matched peak annotations linked to theoretical isotope peaks
- SIP abundance scores for each matched peak
How to apply
Load the full-scan mass spectrum (e.g. FT1 scan) using mzR or Raxport-processed FT2 format and extract the m/z range around the expected precursor (e.g. 880–890 for a +3 charge state). Call annotatePrecursor with the peptide sequence, charge state, isotope atom type (C13, N15, etc.), incorporation probability (between 0 and 1, e.g. 0.0107 for natural ¹³C abundance), and isolation window parameters (center m/z and width). The function internally computes the theoretical isotopic peak envelope using sequential convolution, then matches each observed peak within the isolation window to a theoretical isotope peak, assigning matched indices and calculating SIP abundances based on the isotopic enrichment model. Validate the result by checking that matched peaks cluster near the theoretical envelope, that intensities and m/z values fall within expected ranges, and that the number of matched peaks is consistent with the charge state and incorporation probability.
Related tools
- Aerith (R package providing annotatePrecursor function to compute theoretical isotopic envelopes and match observed peaks to theoretical isotope patterns with SIP abundance scoring) — https://github.com/xyz1396/Aerith
- mzR (Bioconductor package for reading and parsing mass spectrum files in mzML and MGF formats)
- Raxport (Extracts FT1/FT2 scan data from ThermoFisher RAW files for downstream annotation) — https://github.com/xyz1396/Raxport.net
- ThermoRawFileParser (Alternative tool for converting ThermoFisher RAW files to open formats (mzML, MGF) compatible with mass spectrum readers) — https://github.com/CompOmics/ThermoRawFileParser
Evaluation signals
- Matched peaks lie within the specified isolation window (isoCenter ± isoWidth/2 m/z) and cluster near the theoretical isotope envelope.
- ExpectedPrecursorIons table contains no gaps or NaN values in m/z, intensity, charge, or SIPabundances columns; all matched indices are non-negative integers.
- SIP abundances sum to approximately 1.0 (or a known fraction if labeled) and increase monotonically with isotope offset when incorporation probability is uniform.
- Manual visual inspection of the matched peaks against a plotted theoretical envelope confirms alignment within instrumental resolution (e.g. <5 ppm for Orbitrap).
- Number of matched peaks is consistent with the charge state and incorporation probability (e.g. +3 charge state with 1% ¹³C should yield ~3–5 prominent peaks).
Limitations
- Requires accurate precursor m/z and charge state; misspecification leads to false matches in overlapping isotope envelopes.
- Sequential convolution algorithm assumes uniform isotope abundance within a peptide; does not handle intra-peptide positional enrichment biases.
- Isolation window must be wide enough to capture the full isotope envelope; narrow windows (e.g. <2 m/z width) will truncate the distribution and underestimate SIP abundance.
- Performance degrades for multiply-charged peptides (charge ≥ +4) where isotope peaks become closely spaced and harder to resolve.
- Only MS1 (precursor-level) annotation is supported; fragment-level (MS2) SIP annotation requires separate B/Y ion envelope computation via annotatePrecursor with fragment parameters.
Evidence
- [full_text] annotatePrecursor function parameters and output: "annotatePrecursor accepts observed precursor mass, probability, and charge along with peptide sequence, charge state, isotope atom type, incorporation probability, isolation window center and width"
- [full_text] Workflow description from task_004: "Call annotatePrecursor with the peptide sequence HSQVFSTAEDNQSAVTIHVLQGER, charge state +3, C13 labeling, probability 0.0107, isoCenter 886.65, and isoWidth 4.0 to compute theoretical isotopic peak"
- [abstract] Sequential convolution algorithm: "employs efficient algorithms—including sequential convolution for peptide fragments, Monte Carlo simulation for fine isotopic structures, and FFT-based methods for metabolites—to accurately generate"
- [intro] SIP definition and purpose: "Stable isotope probing (SIP) is indeed a powerful technique for tracing the fate of metabolic labels incorporated into cells, offering insights into substrate assimilation and associated metabolic"
- [intro] Flexible isotope abundance specification: "Aerith supports flexible specification of isotopic abundances for stable isotope probing (SIP) experiments, allowing users to model compounds with any degree of isotopic"
1---2name: stable-isotope-probing-abundance-modeling3description: Use when you have a high-resolution mass spectrum (FT scan) containing a peptide precursor at known charge state with known or suspected stable isotope labeling (e.4license: CC-BY-4.05---67# stable-isotope-probing-abundance-modeling89## Summary1011Compute and match observed precursor isotope peaks to theoretical isotopic patterns for natural-abundance or enriched peptides, accounting for stable isotope incorporation probability and charge state. This skill enables quantitative SIP abundance assignment for isotope-labeled peptide precursors within specified m/z isolation windows.1213## When to use1415You have a high-resolution mass spectrum (FT scan) containing a peptide precursor at known charge state with known or suspected stable isotope labeling (e.g. ¹³C, ¹⁵N), a defined m/z isolation window (center and width), and you need to discriminate observed isotope peaks from noise and assign SIP abundances for each matched peak. This is essential when validating SIP-labeled peptide identifications or when manually inspecting PSMs where isotope pattern matching is ambiguous.1617## When NOT to use1819- Precursor m/z or charge state is unknown or highly uncertain; the model will produce spurious matches outside the intended m/z region.20- Isolation window is too narrow relative to peak width, resulting in truncated isotope envelopes and unreliable SIP abundance estimates.21- Input spectrum is unprocessed or contains excessive noise without baseline subtraction; matching will fail or produce false positives.2223## Inputs2425- High-resolution mass spectrum scan (FT1 or Raxport FT2 format, read via mzR)26- Peptide sequence (string, e.g. 'HSQVFSTAEDNQSAVTIHVLQGER')27- Charge state (integer, e.g. +2, +3)28- Isotope atom type (e.g. 'C13', 'N15')29- Incorporation probability (float between 0 and 1)30- Isolation window center m/z (float, e.g. 886.65)31- Isolation window width (float, e.g. 4.0)3233## Outputs3435- ExpectedPrecursorIons table with columns: m/z, intensity, charge, matchedIndices, SIPabundances36- Matched peak annotations linked to theoretical isotope peaks37- SIP abundance scores for each matched peak3839## How to apply4041Load the full-scan mass spectrum (e.g. FT1 scan) using mzR or Raxport-processed FT2 format and extract the m/z range around the expected precursor (e.g. 880–890 for a +3 charge state). Call annotatePrecursor with the peptide sequence, charge state, isotope atom type (C13, N15, etc.), incorporation probability (between 0 and 1, e.g. 0.0107 for natural ¹³C abundance), and isolation window parameters (center m/z and width). The function internally computes the theoretical isotopic peak envelope using sequential convolution, then matches each observed peak within the isolation window to a theoretical isotope peak, assigning matched indices and calculating SIP abundances based on the isotopic enrichment model. Validate the result by checking that matched peaks cluster near the theoretical envelope, that intensities and m/z values fall within expected ranges, and that the number of matched peaks is consistent with the charge state and incorporation probability.4243## Related tools4445- **Aerith** (R package providing annotatePrecursor function to compute theoretical isotopic envelopes and match observed peaks to theoretical isotope patterns with SIP abundance scoring) — https://github.com/xyz1396/Aerith46- **mzR** (Bioconductor package for reading and parsing mass spectrum files in mzML and MGF formats)47- **Raxport** (Extracts FT1/FT2 scan data from ThermoFisher RAW files for downstream annotation) — https://github.com/xyz1396/Raxport.net48- **ThermoRawFileParser** (Alternative tool for converting ThermoFisher RAW files to open formats (mzML, MGF) compatible with mass spectrum readers) — https://github.com/CompOmics/ThermoRawFileParser4950## Evaluation signals5152- Matched peaks lie within the specified isolation window (isoCenter ± isoWidth/2 m/z) and cluster near the theoretical isotope envelope.53- ExpectedPrecursorIons table contains no gaps or NaN values in m/z, intensity, charge, or SIPabundances columns; all matched indices are non-negative integers.54- SIP abundances sum to approximately 1.0 (or a known fraction if labeled) and increase monotonically with isotope offset when incorporation probability is uniform.55- Manual visual inspection of the matched peaks against a plotted theoretical envelope confirms alignment within instrumental resolution (e.g. <5 ppm for Orbitrap).56- Number of matched peaks is consistent with the charge state and incorporation probability (e.g. +3 charge state with 1% ¹³C should yield ~3–5 prominent peaks).5758## Limitations5960- Requires accurate precursor m/z and charge state; misspecification leads to false matches in overlapping isotope envelopes.61- Sequential convolution algorithm assumes uniform isotope abundance within a peptide; does not handle intra-peptide positional enrichment biases.62- Isolation window must be wide enough to capture the full isotope envelope; narrow windows (e.g. <2 m/z width) will truncate the distribution and underestimate SIP abundance.63- Performance degrades for multiply-charged peptides (charge ≥ +4) where isotope peaks become closely spaced and harder to resolve.64- Only MS1 (precursor-level) annotation is supported; fragment-level (MS2) SIP annotation requires separate B/Y ion envelope computation via annotatePrecursor with fragment parameters.6566## Evidence6768- [full_text] annotatePrecursor function parameters and output: "annotatePrecursor accepts observed precursor mass, probability, and charge along with peptide sequence, charge state, isotope atom type, incorporation probability, isolation window center and width"69- [full_text] Workflow description from task_004: "Call annotatePrecursor with the peptide sequence HSQVFSTAEDNQSAVTIHVLQGER, charge state +3, C13 labeling, probability 0.0107, isoCenter 886.65, and isoWidth 4.0 to compute theoretical isotopic peak"70- [abstract] Sequential convolution algorithm: "employs efficient algorithms—including sequential convolution for peptide fragments, Monte Carlo simulation for fine isotopic structures, and FFT-based methods for metabolites—to accurately generate"71- [intro] SIP definition and purpose: "Stable isotope probing (SIP) is indeed a powerful technique for tracing the fate of metabolic labels incorporated into cells, offering insights into substrate assimilation and associated metabolic"72- [intro] Flexible isotope abundance specification: "Aerith supports flexible specification of isotopic abundances for stable isotope probing (SIP) experiments, allowing users to model compounds with any degree of isotopic"
