simSearch                package:xcms                R Documentation

_U_n_r_e_s_t_r_i_c_t_e_d _p_r_e_c_u_r_s_o_r _M_e_t_l_i_n _S_e_a_r_c_h

_D_e_s_c_r_i_p_t_i_o_n:

     A method for searching MS^2 data against the METLIN Database
     without a precursor restraint.

_U_s_a_g_e:

     simSearch(object, ppmfrag=20, percent=50, file, fullReport=FALSE, ...)

_A_r_g_u_m_e_n_t_s:

  object: An xcmsFragment object generated by xcmsRaw.collect

 ppmfrag: Error on fragment masses in ppm

 percent: Percentage thresthold to use for identification

    file: Name of the output files

fullReport: Should a full report be generated

     ...: Arguments to plot.metlin()

_D_e_t_a_i_l_s:

     This method searches the METLIN database for similar MS/MS spectra
     and ranks them on a fragment score and a neutral loss score. Both
     of these scores work on a 'score_fun' method.  The search takes
     xcmsFragment objects and searches the database with an
     unrestricted precursor, thereby searching all spectra in the
     METLIN database. The percent variable can be used to remove
     spectra that are below the accepted percentage similarity. The
     percentage similarity is an independant variable for both the
     fragment search and the neutral loss search.  The method generates
     two files when the fullReport variable is set to TRUE. The default
     file shows the top 5 m/z's most frequently matched. This gives a
     guide as fragments and neutral losses which should be inspected
     with a formula calculator. The second file which is printed to a
     variable and or to the second file is a full report of the data.
     This report includes metabolite names from the METLIN database and
     gives both the fragment score and the neutral loss score thereby
     giving a confidence to the likelyhood of the possible
     molecule/family of molecules.

_V_a_l_u_e:

     A data frame with the following columns:

     m/z: Precursor m/z of the Experimental spectra

   rtmin: Start of the rt window

   rtmax: End of the rt window

Experiment Collision Energy: Experimental spectra Collision Energy

Fragment Score: Score of the Fragments

Neutral Score: Score of the Neutral loss

Common Neutral loss: m/z of the most matching neutral loss

Common Fragment: m/z of the most matching fragment

Compound Name: Name of the compound from METLIN

Metlin Mass: The mass as reported by METLIN

Collision Energy: The collision energy of the metlin spectra

_A_u_t_h_o_r(_s):

     H. Paul Benton, hpbenton@scripps.edu

_R_e_f_e_r_e_n_c_e_s:

     H. Paul Benton, D.M. Wong, S.A.Strauger, G. Siuzdak "XCMS^2:"
     Analytical Chemistry 2008

