mz.unity.search: Perform a combinatorial search for peak relationships in mass...

Description Usage Arguments Details Value See Also

Description

mz.unity.search searches <m,z> values supplied in B and M for combinations which sum to a <m,z> value in A.

Usage

1
2
mz.unity.search(A, B, M, ppm, BM.limits = cbind(M.min = c(0, 0, 0), M.max =
  c(0, 1, 3), B.n = c(1, 2, 3)))

Arguments

A

Matrix containing columns named "m" and "z". Column "m" is an exact mass. Column "z" is an integer charge.

B

Matrix containing columns named "m", "z", and "d". Column "d" is one of -1, 0, 1 denoting weather this species may be added (1) or subtracted (-1) or both (0).

M

Matrix. See B.B and M differ in that they can be included in different proportions as specified in variable BM.limits.

ppm

Numeric. The mass error allowed when defining mass equality. This is per included species in A and B.

BM.limits

Matrix containing columns names "M.min", "M.max", "B.n". This defines the combinatorial depth with which to seach B and M. For the number of species specified in B.n we search the range of values specified in M.min:M.max

Details

This function encapsulates the combinatorial search for simple and complex peak relationships. The search is very general and can be tailored to a specific type of relationship with the parameters BM.limits and M. M allows you to specify additional granular formula which are not present in A and B yet could relate peaks. This inlcudes things like isotopic masses and small ions. BM.limits specifies the combinatorial depth with which to search. For isotopes in which no intermediate masses are missing BM.limits could be 1, 1, 1. We can search beyond one missing peak with 1,2,1.

Several sets of granular formula are included by default. They include isotopes (M.iso), charge carriers (M.z), and neutral formula (M.n). These can be combined or extended to build a search for any set of relationships. It is generally useful to keep the set of granular formula in small groups appropriate for the combinatorial depth. For example, isotopes generally require only a single step, whereas we may want to search for cross-polarity relationships which require the exchange of two or more charge carriers.

Value

A matrix. Rows correspond to a detected relationship. Columns include "ppm", "A", multiple "B.*", and multiple "M.*". A, B, and M are integers referencing the rows of the supplied matrices. ppm is the mass error when comparing the sum of B and M with the mass of A.

See Also

See https://github.com/nathaniel-mahieu/mz-unity for examples.


nathaniel-mahieu/mz.unity documentation built on May 23, 2019, 12:19 p.m.