Skip to content

User Library

Description

This module compares molecular features against a user-provided (targeted) spectral library. The matching algorithm works as follows:

  • For each feature, its MS/MS fragmentation spectrum is matched pairwise with each library spectrum, using one or more different algorithms described below.
  • For the modified cosine algorithm, library matches are only retained if feature and library spectra share a minimum number of matched peaks within a certain fragment tolerance, reach a cutoff score, and are inside a maximum precursor mass difference.
  • For the MS2DeepScore algorithm, library matches are only retained if feature and library spectra reach a certain cutoff score and are inside a maximum precursor mass difference.

Limitations

  • Spectral library matching is prohibitively slow with large spectral libraries (especially using the MS2DeepScore algorithm). Therefore, a targeted spectral library should be provided. For a more general library, see MS2Query annotation.

Parameters modified cosine

Key Possible Values Default
activate_module true, false false
min_nr_matched_peaks >=1 5
fragment_tol >0 0.1
score_cutoff 0.0-1.0 0.7
max_precursor_mass_diff >=1 600

Explanation

  • fragment_tol: the absolute tolerance for matching two MS/MS fragments, in m/z units.
  • min_nr_matched_peaks: minimum number of fragments that must be matched between two MS/MS fragmentation spectra.
  • score_cutoff: minimum score to consider a match
  • max_precursor_mass_diff: maximum allowed difference between precursor m/z of feature and library m/z.

Parameters ms2deepscore

Key Possible Values Default
activate_module true, false false
score_cutoff 0.0-1.0 0.8
max_precursor_mass_diff >=1 600

Explanation

  • score_cutoff: minimum score to consider a match
  • max_precursor_mass_diff: maximum allowed difference between precursor m/z of feature and library m/z.