Derivatizing matrix ionization rule application

derivatizing-matrix-ionization-rule-application

Summary

Apply matrix-specific adduct ionization rulesets to predict non-standard ion forms (beyond [M+H]+ and [M-H]-) that arise from derivatizing matrices like FMP-10 in mass spectrometry metabolite identification. This skill is essential for correctly identifying metabolites when chemical derivatization alters the ionization behavior in MSI experiments.

When to use

When working with mass spectrometry imaging data from metabolites treated with derivatizing matrices (e.g., FMP-10) that produce adduct ions beyond the common [M+H]+ in positive mode and [M-H]- in negative mode, and you need to enumerate and validate predicted m/z values for metabolite annotation.

When NOT to use

• Input metabolites are not chemically derivatized or are analyzed under standard ionization conditions ([M+H]+, [M-H]- only).
• Matrix-specific adduct ruleset is unknown or unavailable for the derivatizing matrix being used.
• Input SMILES cannot be parsed or validated as a valid molecular structure by RDKit.

Inputs

• Metabolite SMILES string
• Derivatizing matrix identifier (e.g., 'FMP-10')
• Matrix-specific adduct ruleset (lookup table or configuration file mapping ionization rules to mass shifts)

Outputs

• Adduct ion prediction table (columns: adduct formula, mass shift, predicted m/z, ionization mode)
• Validated adduct ion list (filtered against reference matrix characterization data)

How to apply

Parse the input metabolite structure as SMILES and identify the derivatizing matrix identifier (e.g., FMP-10). Load the matrix-specific adduct ionization ruleset (which maps derivatizing matrix modifications and ionization states to mass shifts). For each adduct rule, use RDKit to calculate molecular weight and apply the matrix-specific mass modification to compute expected m/z. Generate a table of predicted adduct ions with formulas, mass shifts, and m/z values. Compare the predicted m/z against reference data from published matrix characterization studies (e.g., Nature Methods FMP-10 dataset) to validate rule accuracy and filter false positives based on literature-reported adduct patterns.

Related tools

• RDKit (Parse metabolite SMILES, construct molecular graphs, validate structures, and compute molecular weights for m/z prediction) — https://www.rdkit.org/

Evaluation signals

• Predicted m/z values for all enumerated adducts fall within expected tolerance of reference matrix characterization data (e.g., FMP-10 Nature Methods dataset).
• Adduct formulas and mass shifts are consistent with known ionization chemistry for the specified derivatizing matrix.
• No RDKit parsing or validation errors on input SMILES; molecular structure graph is chemically valid.
• All adduct m/z predictions are sorted and indexed consistently; table schema includes required columns (formula, mass shift, m/z, mode).
• Comparison output indicates agreement or discrepancy with literature reference values, flagging novel or unexpected adducts for manual review.

Limitations

• Skill is dependent on the availability and accuracy of the matrix-specific adduct ruleset; if the ruleset is incomplete or derived from limited reference data, predictions may be incomplete or incorrect.
• RDKit molecular weight calculations assume standard atomic masses and do not account for isotopic variants; isotopic fine-structure predictions are not supported.
• The skill assumes the input SMILES is chemically realistic and non-ambiguous; highly complex or ambiguously drawn structures may fail RDKit validation.
• Mat-ID is extendable to any derivatizing matrix in principle, but as of the README publication, FMP-10 is the primary validated use case; other matrices require manual ruleset development and validation.

Evidence

• [other] Parse input metabolite SMILES and matrix identifier using RDKit to construct the molecular graph and validate structure.: "Parse input metabolite SMILES and matrix identifier using RDKit to construct the molecular graph and validate structure."
• [other] Query or load the matrix-specific adduct ionization ruleset (e.g., FMP-10 adduct patterns from Nature Methods reference data).: "Query or load the matrix-specific adduct ionization ruleset (e.g., FMP-10 adduct patterns from Nature Methods reference data)."
• [other] For each adduct rule in the matrix profile, apply RDKit molecular weight calculation to compute the expected m/z accounting for the derivatizing matrix modification and ionization state.: "For each adduct rule in the matrix profile, apply RDKit molecular weight calculation to compute the expected m/z accounting for the derivatizing matrix modification and ionization state."
• [readme] Met-ID has a particular focus on derivatizing matrices leading to other ions than the common [M+H]+ in positive mode and [M-H]- in negative mode.: "Met-ID has a particular focus on derivatizing matrices leading to other ions than the common [M+H]+ in positive mode and [M-H]- in negative mode."
• [readme] Met-ID is extendable to use any derivatizing matrix with the tools to do local version changes right from inside the software.: "Met-ID is extendable to use any derivatizing matrix with the tools to do local version changes right from inside the software."