OpenMS
Adduct.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: Chris Bielow $
32 // $Authors: $
33 // --------------------------------------------------------------------------
34 
35 #pragma once
36 
37 #include <OpenMS/OpenMSConfig.h>
38 #include <OpenMS/CONCEPT/Types.h>
40 
41 namespace OpenMS
42 {
43 
44  class OPENMS_DLLAPI Adduct
45  {
46 public:
47 
48  typedef std::vector<Adduct> AdductsType;
49 
51  Adduct();
52 
54  Adduct(Int charge);
55 
57  Adduct(Int charge, Int amount, double singleMass, const String& formula, double log_prob, double rt_shift, const String& label = "");
58 
60  Adduct operator*(const Int m) const;
62  Adduct operator+(const Adduct& rhs);
64  void operator+=(const Adduct& rhs);
65 
66 
68  friend OPENMS_DLLAPI std::ostream& operator<<(std::ostream& os, const Adduct& a);
69 
71  friend OPENMS_DLLAPI bool operator==(const Adduct& a, const Adduct& b);
72 
74  const Int& getCharge() const;
75 
76  void setCharge(const Int& charge);
77 
78  const Int& getAmount() const;
79  void setAmount(const Int& amount);
80 
81  const double& getSingleMass() const;
82  void setSingleMass(const double& singleMass);
83 
84  const double& getLogProb() const;
85  void setLogProb(const double& log_prob);
86 
87  const String& getFormula() const;
88  void setFormula(const String& formula);
89 
90  const double& getRTShift() const;
91  const String& getLabel() const;
92 
93  // convert a ion string to adduct string with charge information (eg. ion_string = "Na1", charge = "1" --> "[M+Na]+")
94  String toAdductString(const String& ion_string, const Int& charge);
95  //}
96 
97 private:
100  double singleMass_;
101  double log_prob_;
103  double rt_shift_;
105 
106  String checkFormula_(const String& formula);
107 
108  };
109 
110 } // namespace OpenMS
111 
112 
Definition: Adduct.h:45
void setLogProb(const double &log_prob)
String checkFormula_(const String &formula)
Adduct operator+(const Adduct &rhs)
Add two adducts amount if they are equal (defined by equal formula)
Adduct()
Default C'tor.
double log_prob_
log probability of observing a single entity of this adduct
Definition: Adduct.h:101
void setCharge(const Int &charge)
Adduct operator*(const Int m) const
Increase amount of this adduct by factor.
friend bool operator==(const Adduct &a, const Adduct &b)
Comparator.
String formula_
chemical formula (parsable by EmpiricalFormula)
Definition: Adduct.h:102
void setAmount(const Int &amount)
String toAdductString(const String &ion_string, const Int &charge)
void operator+=(const Adduct &rhs)
Add other adducts amount to *this (equal formula required!)
const double & getLogProb() const
Adduct(Int charge)
C'tor with initial charge.
String label_
Label for this adduct (can be used to indicate heavy labels)
Definition: Adduct.h:104
double rt_shift_
RT shift induced by a single entity of this adduct (this is for adducts attached prior to ESI,...
Definition: Adduct.h:103
const String & getLabel() const
std::vector< Adduct > AdductsType
Definition: Adduct.h:48
void setSingleMass(const double &singleMass)
const String & getFormula() const
Adduct(Int charge, Int amount, double singleMass, const String &formula, double log_prob, double rt_shift, const String &label="")
C'tor for all members.
void setFormula(const String &formula)
const double & getSingleMass() const
double singleMass_
mass of a single entity
Definition: Adduct.h:100
const Int & getAmount() const
const Int & getCharge() const
Int amount_
number of entities
Definition: Adduct.h:99
const double & getRTShift() const
Int charge_
usually +1
Definition: Adduct.h:98
friend std::ostream & operator<<(std::ostream &os, const Adduct &a)
Print the contents of an Adduct to a stream.
A more convenient string class.
Definition: String.h:60
int Int
Signed integer type.
Definition: Types.h:102
Main OpenMS namespace.
Definition: FeatureDeconvolution.h:48