OpenMS
IsotopeLabelingMDVs.h
Go to the documentation of this file.
1 // --------------------------------------------------------------------------
2 // OpenMS -- Open-Source Mass Spectrometry
3 // --------------------------------------------------------------------------
4 // Copyright The OpenMS Team -- Eberhard Karls University Tuebingen,
5 // ETH Zurich, and Freie Universitaet Berlin 2002-2023.
6 //
7 // This software is released under a three-clause BSD license:
8 // * Redistributions of source code must retain the above copyright
9 // notice, this list of conditions and the following disclaimer.
10 // * Redistributions in binary form must reproduce the above copyright
11 // notice, this list of conditions and the following disclaimer in the
12 // documentation and/or other materials provided with the distribution.
13 // * Neither the name of any author or any participating institution
14 // may be used to endorse or promote products derived from this software
15 // without specific prior written permission.
16 // For a full list of authors, refer to the file AUTHORS.
17 // --------------------------------------------------------------------------
18 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19 // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 // ARE DISCLAIMED. IN NO EVENT SHALL ANY OF THE AUTHORS OR THE CONTRIBUTING
22 // INSTITUTIONS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
23 // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
24 // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
25 // OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
26 // WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
27 // OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
28 // ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 //
30 // --------------------------------------------------------------------------
31 // $Maintainer: Ahmed Khalil $
32 // $Authors: Ahmed Khalil $
33 // --------------------------------------------------------------------------
34 
35 #pragma once
36 
40 #include <OpenMS/KERNEL/Feature.h>
41 
42 namespace OpenMS
43 {
48  class OPENMS_DLLAPI IsotopeLabelingMDVs :
49  public DefaultParamHandler
50  {
51  public:
55 
59 
61  {
62  NOT_SELECTED,
63  TBDMS,
64  SIZE_OF_DERIVATIZATIONAGENT
65  };
66 
67  enum class MassIntensityType
68  {
69  NORM_MAX,
70  NORM_SUM,
71  SIZE_OF_MASSINTENSITYTYPE
72  };
73 
74  static const std::string NamesOfDerivatizationAgent[static_cast<int>(DerivatizationAgent::SIZE_OF_DERIVATIZATIONAGENT)];
75 
76  static const std::string NamesOfMassIntensityType[static_cast<int>(MassIntensityType::SIZE_OF_MASSINTENSITYTYPE)];
77 
93  const Feature& normalized_feature, Feature& corrected_feature,
94  const Matrix<double>& correction_matrix, const DerivatizationAgent& correction_matrix_agent);
95 
111  const FeatureMap& normalized_featureMap, FeatureMap& corrected_featureMap,
112  const Matrix<double>& correction_matrix, const DerivatizationAgent& correction_matrix_agent);
113 
126  Feature& normalized_feature,
127  const std::vector<double>& experiment_data, const std::string& isotopic_purity_name);
128 
141  FeatureMap& normalized_featureMap,
142  const std::vector<std::vector<double>>& experiment_data, const std::vector<std::string>& isotopic_purity_name);
143 
153  Feature& normalized_feature,
154  const std::string& feature_name, const std::string& fragment_isotopomer_theoretical_formula);
155 
165  FeatureMap& normalized_featureMap,
166  const std::string& feature_name,
167  const std::map<std::string, std::string>& fragment_isotopomer_theoretical_formulas);
168 
180  const Feature& measured_feature, Feature& normalized_feature,
181  const MassIntensityType& mass_intensity_type, const std::string& feature_name);
182 
194  const FeatureMap& measured_featureMap, FeatureMap& normalized_featureMap,
195  const MassIntensityType& mass_intensity_type, const std::string& feature_name);
196 
197  protected:
199  void updateMembers_() override;
200  };
201 }
A base class for all classes handling default parameters.
Definition: DefaultParamHandler.h:92
A container for features.
Definition: FeatureMap.h:106
An LC-MS feature.
Definition: Feature.h:72
IsotopeLabelingMDVs is a class to support and analyze isotopic labeling experiments (i....
Definition: IsotopeLabelingMDVs.h:50
void calculateIsotopicPurity(Feature &normalized_feature, const std::vector< double > &experiment_data, const std::string &isotopic_purity_name)
This function calculates the isotopic purity of the MDV using the following formula: isotopic purity ...
MassIntensityType
Definition: IsotopeLabelingMDVs.h:68
void calculateMDVAccuracies(FeatureMap &normalized_featureMap, const std::string &feature_name, const std::map< std::string, std::string > &fragment_isotopomer_theoretical_formulas)
This function calculates the accuracy of the MDVs as compared to the theoretical MDVs (only for 12C q...
void isotopicCorrections(const FeatureMap &normalized_featureMap, FeatureMap &corrected_featureMap, const Matrix< double > &correction_matrix, const DerivatizationAgent &correction_matrix_agent)
This function performs an isotopic correction to account for unlabeled abundances coming from the der...
void calculateMDVs(const FeatureMap &measured_featureMap, FeatureMap &normalized_featureMap, const MassIntensityType &mass_intensity_type, const std::string &feature_name)
This function calculates the mass distribution vector (MDV) either normalized to the highest mass int...
~IsotopeLabelingMDVs() override
Destructor.
void isotopicCorrection(const Feature &normalized_feature, Feature &corrected_feature, const Matrix< double > &correction_matrix, const DerivatizationAgent &correction_matrix_agent)
This function performs an isotopic correction to account for unlabeled abundances coming from the der...
void calculateMDVAccuracy(Feature &normalized_feature, const std::string &feature_name, const std::string &fragment_isotopomer_theoretical_formula)
This function calculates the accuracy of the MDV as compared to the theoretical MDV (only for 12C qua...
void updateMembers_() override
Synchronize members with param class.
DerivatizationAgent
Definition: IsotopeLabelingMDVs.h:61
void calculateMDV(const Feature &measured_feature, Feature &normalized_feature, const MassIntensityType &mass_intensity_type, const std::string &feature_name)
This function calculates the mass distribution vector (MDV) either normalized to the highest mass int...
void calculateIsotopicPurities(FeatureMap &normalized_featureMap, const std::vector< std::vector< double >> &experiment_data, const std::vector< std::string > &isotopic_purity_name)
This function calculates the isotopic purity of the MDVs using the following formula: isotopic purity...
Main OpenMS namespace.
Definition: FeatureDeconvolution.h:48