getMolecule: Calculate mass and isotope information for a molecule given...

In sneumann/Rdisop: Decomposition of Isotopic Patterns

Calculate mass and isotope information for a molecule given as sum formula

Description

Parse the sum formula and calculate the theoretical exact mass and the isotope distribution for an approximate MS resolution of 20,000 (i.e. not providing the isotopic fine structure).

Usage

getMolecule(formula, elements = NULL, z = 0, maxisotopes = 10)

getMass(molecule)

getMonoisotopic(molecule)

getIsotope(molecule, index)

getFormula(molecule)

getScore(molecule)

getValid(molecule)

Arguments

formula	Sum formula.
elements	List of allowed chemical elements, defaults to full periodic system of elements. See initializeElements.
z	Charge z of molecule for exact mass calculation.
maxisotopes	Maximum number of isotopes shown for the resulting molecule.
molecule	An initialized molecule as returned by getMolecule() or the decomposeMass() and decomposeIsotope() functions.
index	Return the n-th isotope mass/abundance pair(s) of the molecule

Details

getMolecule() will parse the sum formula and calculate the exact mass and the isotope distribution. The exact mass is the mass of the most abundant isotope and is not identical with the monoisotopic mass. The latter can be extracted using the function 'getMonoisotopic()'. This function can also be supplied with a vector of chemical formulas directly (in case that the isotopic distribution is of no interest). Since of version 1-65-3, if a charge is specified, the exact mass of the molecule will be reduced or increased by n-times the electron mass (depending on the sign). Also, isotopic masses will additionally be divided by the charge specified to reflect what would be measured in HR-MS.

Value

A list containing the elements 'formula' (repeated sum formula), 'mass' exact mass of molecule, 'score' probability, for given molecules a dummy value which is always 1.0, 'valid' result of neutrogen rule check, 'isotopes' a list of isotope masses and abundances.

Author(s)

Steffen Neumann <[e-mail]>

References

For a description of the underlying IMS see citation("Rdisop")

Examples

# Ethanol
getMolecule("C2H6O")

sneumann/Rdisop documentation built on Dec. 14, 2024, 7:10 a.m.