ecl-logo Documentation
ECL`

AnalyzeMassSpectrumDeconvolution

AnalyzeMassSpectrumDeconvolution[Data]Object

denoises and centroids spectral data, and then combines peaks corresponding to analytes of the same elemental composition, but different isotopic compositions, into monoisotopic peaks. Optionally, peaks with known charge states can be shifted to the corresponding single-charged position.

AnalyzeMassSpectrumDeconvolution[Protocol]Object

denoises and centroids spectral data in the linked objects of the Data field of the Protocol, and then combines peaks corresponding to analytes of the same elemental composition, but different isotopic compositions, into monoisotopic peaks. Optionally, peaks with known charge states can be shifted to the corresponding single-charged position.

Details

  • The purpose of this function is to detect and combine the peaks of isotopic clusters in mass spectrum data, and generate a spectrum with reduced complexity for use in additional analyses, such as spectral annotation, with increased effectiveness. Isotopic clusters, which are set of peaks corresponding to analytes of the same elemental composition, but different isotopic compositions, are identified via an algorithm with requires no prior knowledge of the analytes. First, the algorithm removes noise and creates a list of centroided peaks. Then, starting from the lowest m/z value, the algorithm scans each peak in the spectrum, and for each peak, checks if the position is within some distance of the previous peak. If the option UseDecreasingModel is set to True, the algorithm also checks that the intensity of the peak is less than the intensity of the previous peak. If a peak satisfies both the position and intensity criteria relative to the previous peak, the peak is added to the isotopic cluster. This process continues until some peak does not satisfy the criteria, at which point, the algorithm will begin assigning peaks to a new isotopic cluster. Once the algorithm has successfully identified all the peaks of an isotopic cluster, it creates a monoisotopic peak in the deconvoluted spectrum corresponding to that cluster. More detail can be found in the following paper: https://pubs.acs.org/doi/full/10.1021/acs.jproteome.0c00544.
  • Input
    Output
    Peak Clustering Options
    Post-Processing Options
    Pre-Processing Options
    Method Options
    Messages
  • ChargeRangeMinCharge value cannot be greater than MaxCharge value. Reverting to default value.
    FatalErrorSomething went wrong internally. This may be due to network connectivity issues, so re-try the function call after waiting a couple of minutes.
    IsotopicPeaksRangeMin IsotopicPeaks value cannot be greater than Max IsotopicPeaks value. Reverting to default value.
    MassSpectrometryObjectThis function may be slow for MassSpectrometry data objects which do not yet contain an MzMLFile. Consider using Compute. The first time this function is run, an MzMLFile will be added to the data object, allowing for much faster analysis in the future.
    OutputOptionAnalyzeMassSpectrumDeconvolution does not support the Output options Preview and Result simultaneously; Must use only one at a Time. Output options Options and Tests can be used with either.
    ProtocolObjectThis function may be slow for large protocol objects. Consider using Compute.
    StartIntensityCheckThe option StartIntensityCheck has no effect on the results if the option IncludeDecreasingCheck is set to False.

Examples

open allclose all

Basic Examples  (4)

Run deconvolution analysis for a single Object[Data, ChromatographyMassSpectra]:

Run deconvolution analysis for a single Object[Data, MassSpectrometry]:

Run deconvolution analysis for a single Object[Protocol, LCMS]:

Run deconvolution analysis for a single Object[Protocol, MassSpectrometry]:

Additional Examples  (2)

Output->Preview returns a graphics object:

Output->Preview returns a SlideView of graphics objects:

Options  (12)

AveragineClustering  (1)

AveragineClustering can be set to False, and isotopic clusters are determined only by the FragmentTolerance and IsotopicPeaksRange options:

ChargeDeconvolution  (1)

ChargeDeconvolution can be set to True to shift the deisotoped peaks to their single-charged equivalent position:

IntensityThreshold  (1)

IntensityThreshold sets the minimum intensity for a data point in the data set. Values below the threshold will be removed before deisotoping:

IsotopicPeakTolerance  (1)

IsotopicPeakTolerance sets the maximum allowed deviation from expected peak position:

KeepOnlyDeisotoped  (1)

KeepOnlyDeisotoped can be set to False to retain peak information for fragments without isotopic peaks:

MaxCharge  (1)

MaxCharge can be adjusted to examine only multiply charged fragments:

MaxIsotopicPeaks  (1)

MaxIsotopicPeaks can be adjusted to examine clusters with a large number of isotopic peaks:

MinCharge  (1)

MinCharge can be adjusted to examine only multiply charged fragments:

MinIsotopicPeaks  (1)

MinIsotopicPeaks can be adjusted to examine clusters with a large number of fragments:

SmoothingWidth  (1)

SmoothingWidth sets the standard deviation of a Gaussian noise filter that is used to denoise the data:

StartIntensityCheck  (1)

StartIntensityCheck can be increased to delay the intensity check performed when AveragineClustering is set to True:

SumIntensity  (1)

SumIntensity can be set to False, such that the intensity of the deisotoped peaks is the highest intensity peak in the isotopic cluster:

Messages  (6)

ChargeRange  (1)

Message is thrown when ChargeRange option is not ordered:

FatalError  (1)

A message is thrown when we cannot contact the server, or an error is returned:

IsotopicPeaksRange  (1)

A message is thrown when IsotopicPeaksRange option is not ordered:

OutputOption  (1)

A message is thrown when Output includes both Result and Preview:

ProtocolObject  (1)

A warning is thrown when Protocol object inputs are used during a local evaluation:

StartIntensityCheck  (1)

A message is thrown when StartIntensityCheck is specified along with DecreasingCheck->False:

Last modified on Thu 18 Sep 2025 15:08:19