libpappsomspp
Library for mass spectrometry
types.h
Go to the documentation of this file.
1/**
2 * \file pappsomspp/types.h
3 * \date 4/3/2015
4 * \author Olivier Langella
5 * \brief This header contains all the type re-definitions and all
6 * the global variables definitions used in the PAPPSOms++ library.
7 */
8
9/*******************************************************************************
10 * Copyright (c) 2015 Olivier Langella <Olivier.Langella@moulon.inra.fr>.
11 *
12 * This file is part of the PAPPSOms++ library.
13 *
14 * PAPPSOms++ is free software: you can redistribute it and/or modify
15 * it under the terms of the GNU General Public License as published by
16 * the Free Software Foundation, either version 3 of the License, or
17 * (at your option) any later version.
18 *
19 * PAPPSOms++ is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU General Public License for more details.
23 *
24 * You should have received a copy of the GNU General Public License
25 * along with PAPPSOms++. If not, see <http://www.gnu.org/licenses/>.
26 *
27 * Contributors:
28 * Olivier Langella <Olivier.Langella@moulon.inra.fr> - initial API and
29 *implementation
30 ******************************************************************************/
31
32#pragma once
33
34#include <QString>
35#include <cstdint>
36
37namespace pappso
38{
39
40/************ Typedefs **************************************************/
41
42/** \var typedef QString PeptideStr
43 \brief A type definition for PeptideStr
44 */
45typedef QString PeptideStr;
46
47/** \var typedef double pappso_double
48 \brief A type definition for doubles
49 */
50typedef double pappso_double;
51
52/** \var typedef float mcq_float
53 \brief A type definition for floats
54 */
55typedef float pappso_float;
56
57typedef unsigned int uint;
58
59/*********** enumerations *********************************/
60
61/** \def TimeUnit (s, min, h)
62 */
63enum class TimeUnit
64{
65 none,
66 s,
67 min,
68 h,
69};
70
71
72/** \def PrecisionUnit ppm or dalton
73 *
74 */
75enum class PrecisionUnit
76{
77 none,
78 dalton,
79 ppm,
80 res,
81 mz,
82 last
83};
84
85/** \def AtomIsotopeSurvey list of atoms on which isotopes may occurs
86 *
87 */
88enum class AtomIsotopeSurvey : std::int8_t
89{
90 C,
91 H,
92 O,
93 N,
94 S,
95 last
96};
97
98
99/** \def Isotope list of isotopes taken into account for peptide abundance
100 * calculation
101 *
102 */
103enum class Isotope
104{
105 C13,
106 H2,
107 O17,
108 O18,
109 N15,
110 S33,
111 S34,
112 S36
113};
114
115
116/** \def MzFormat mz data file format types
117 *
118 */
119enum class MzFormat : std::int8_t
120{
121 unknown = 0, ///< unknown format
122 mzML = 1, ///< mzML
123 mzXML = 2, ///< mzXML
124 MGF = 3, ///< Mascot format
125 SQLite3 = 4, ///< SQLite3 format
126 xy = 5, ///< (x,y) format
127 mz5 = 6, //< MZ5 format
128 msn = 7, //< MS_MS2 format
129 abSciexWiff = 8,
130 abSciexT2D = 9,
132 thermoRaw = 11,
133 watersRaw = 12,
134 brukerFid = 13,
135 brukerYep = 14,
136 brukerBaf = 15,
137 brukerTims = 16,
138 last = 17
139};
140
141
142/** \def FileReaderType mass data file reader types
143 *
144 */
146{
147 pwiz,
148 xy,
149 tims,
151 tims_ms2,
152};
153
154
155/** \def AminoAcidChar Amino-acid full name and code correspondence
156 *
157 */
158enum class AminoAcidChar : char
159{
160 alanine = 'A',
161 cysteine = 'C',
162 aspartic_acid = 'D',
163 glutamic_acid = 'E',
164 phenylalanine = 'F',
165 glycine = 'G',
166 histidine = 'H',
167 isoleucine = 'I',
168 lysine = 'K',
169 leucine = 'L',
170 methionine = 'M',
171 asparagine = 'N',
172 proline = 'P',
173 glutamine = 'Q',
174 arginine = 'R',
175 serine = 'S',
176 threonine = 'T',
177 valine = 'V',
178 tryptophan = 'W',
179 tyrosine = 'Y',
180 selenocysteine = 'U',
181 pyrrolysine = 'O',
182};
183
184
185enum class SortType : std::int8_t
186{
187 no_sort = 0,
188 x = 1,
189 y = 2,
190};
191
192
193enum class SortOrder : std::int8_t
194{
195 ascending = 0,
196 descending = 1,
197};
198
199/** \def Data compression types
200 *
201 */
202enum class DataCompression : std::int8_t
203{
204 unset = -1, ///< not net
205 none = 0, ///< no compression
206 zlib = 1, ///< zlib compresssion
207};
208
209
210enum class DataKind : std::int8_t
211{
212 unset = -1, ///< not set
213 rt = 0, ///< Retention time
214 dt = 1, ///< Drift time
215 mz = 2, ///< m/z
216};
217
218
219enum class Axis : std::int8_t
220{
221 unset = 0x000,
222 x = 1 << 0,
223 y = 1 << 1,
224 z = 1 << 2,
225};
226
227
228enum class AxisScale : std::int8_t
229{
230 unset = 0,
231 orig = 1,
232 log10 = 2,
233};
234
235
236/** \def XixExtactMethod method to extract Xic
237 *
238 */
239enum class XicExtractMethod : std::int8_t
240{
241 sum = 1, ///< sum of intensities
242 max = 2 ///< maximum of intensities
243};
244
245
246/*********** Global variables definitions*********************************/
247
248/** \def MHPLUS 1.007276466879
249 \brief The (monoisotopic) mass of the H+ ion
250 https://en.wikipedia.org/wiki/Proton (One Proton alone)
251 1.007276466879
252 */
253const pappso_double MHPLUS(1.007276466879);
254const pappso_double MPROTON(1.007276466879);
255
256/** \def MPROTIUM 1.00782503207
257 \brief The (monoisotopic) mass of the H atom
258 https://en.wikipedia.org/wiki/Isotopes_of_hydrogen (One proton + One electron)
259 1.00782503207
260
261 Note that as of 20191028, that same page says: 1.007825032241
262 */
263const pappso_double MPROTIUM(1.007825032241);
264
265
266/** \def ONEMILLION 1000000
267 \brief One million integer, why not.
268 */
270
271
272/** @file
273 * https://forgemia.inra.fr/pappso/massxpert/-/blob/be60e53480f68d36afa95c809cffd68d4fb46c79/data/polChemDefs/protein-1-letter-libisospec-atomic-data/protein-1-letter-libisospec-atomic-data.xml
274 * abundance of sulfur extracted from 'massXpert' polymer definitions
275 */
276// <name>Sulfur</name>
277// <symbol>S</symbol>
278// <isotope>
279// <mass>31.9720711741</mass>
280// <abund>94.985001199904004920426814351230859756469726562500000000000000</abund>
281// </isotope>
282// <isotope>
283// <mass>32.9714589101</mass>
284// <abund>0.751939844812414937003097747947322204709053039550781250000000</abund>
285// </isotope>
286// <isotope>
287// <mass>33.9678670300</mass>
288// <abund>4.252059835213182203972337447339668869972229003906250000000000</abund>
289// </isotope>
290// <isotope>
291// <mass>35.9670812000</mass>
292// <abund>0.010999120070394368536836893213148869108408689498901367187500</abund>
293// </isotope>
294
295
296const pappso_double MASSOXYGEN(15.99491461956);
299const pappso_double MASSNITROGEN(14.0030740048);
302const pappso_double MASSPHOSPHORUS(30.973761998);
303const pappso_double MASSSULFUR(31.9720711741);
304
305// id: MOD:00696 name: phosphorylated residue H 1 O 3 P 1
308
309// Selenium : warning lot of isotopes
310const pappso_double MASSSELENIUM(79.916520); // 79.916520 //78.971
311
312// CHNOS
313
314/** \def DIFFC12C13 1.0033548378
315 \brief The (monoisotopic) mass difference between C12 (12u) and C13 stable
316 isotope of carbon
317 */
318const pappso_double DIFFC12C13(1.0033548378);
319
320/** \def DIFFS32S33 0.99938776
321 \brief The (monoisotopic) mass difference between S32 (31.97207100u) and S33
322 (32.97145876u) stable isotope of sulfur
323 https://en.wikipedia.org/wiki/Isotopes_of_sulfur
324 */
325const pappso_double DIFFS32S33(32.9714589101 - MASSSULFUR);
326
327/** \def DIFFS32S34 1.9957959
328 \brief The (monoisotopic) mass difference between S32 (31.97207100u) and S34
329 (33.96786690u) stable isotope of sulfur
330 */
331const pappso_double DIFFS32S34(33.9678670300 - MASSSULFUR);
332
333/** \def DIFFS32S36 3.99500976
334 \brief The (monoisotopic) mass difference between S32 (31.97207100u) and S36
335 (35.96708076u) stable isotope of sulfur
336 */
337const pappso_double DIFFS32S36(35.9670812000 - MASSSULFUR);
338
339
340/** \def DIFFH1H2
341 \brief The (monoisotopic) mass difference between H1 and H2 stable isotope of
342 hydrogen
343 */
344const pappso_double DIFFH1H2(2.0141017778 - MPROTIUM);
345
346/** \def DIFFO16O18
347 \brief The (monoisotopic) mass difference between O16 and O18 stable isotope of
348 oxygen
349 */
351
352/** \def DIFFO16O17
353 \brief The (monoisotopic) mass difference between O16 and O17 stable isotope of
354 oxygen
355 */
357
358/** \def DIFFN14N15
359 \brief The (monoisotopic) mass difference between N14 and N15 stable isotope of
360 nitrogen
361 */
362const pappso_double DIFFN14N15(15.0001088982 - MASSNITROGEN);
363
364
365// http://education.expasy.org/student_projects/isotopident/htdocs/motza.html
366/** \def ABUNDANCEH2 0.0156%
367 \brief H2 isotope abundance
368 */
369const pappso_double
370 ABUNDANCEH2(0.00011570983569203332000374651045149221317842602729797363281250);
371
372/** \def ABUNDANCEN15 0.00364
373 \brief N15 isotope abundance
374 */
376 0.00364198543205827118818262988497735932469367980957031250000000);
377
378/** \def ABUNDANCEO17
379 \brief O17 isotope abundance
380 */
382 0.00038099847600609595965615028489992255344986915588378906250000);
383
384/** \def ABUNDANCEO18 0.2%
385 \brief O18 isotope abundance
386 */
388 0.00205139179443282221315669744399201590567827224731445312500000);
389
390/** \def ABUNDANCEC13 1.109%
391 \brief C13 isotope abundance
392 */
394 0.01078805814953308406245469086570665240287780761718750000000000);
395
396/** \def ABUNDANCEC12 98.89%
397 \brief C12 abundance
398 */
400 0.98921194185046687152862432412803173065185546875000000000000000);
401
402
403/** \def ABUNDANCES33 0.00750
404 \brief S33 abundance
405 */
407 0.00751939844812414937003097747947322204709053039550781250000000);
408
409/** \def ABUNDANCES34 0.0429
410 \brief S34 abundance
411 */
413 0.04252059835213182203972337447339668869972229003906250000000000);
414
415/** \def ABUNDANCES36 0.00020
416 \brief S36 abundance
417 */
419 0.00010999120070394368536836893213148869108408689498901367187500);
420
421
422/** \brief PeptideIon enum defines all types of ions (Nter or Cter)
423 */
424enum class PeptideIon : std::int8_t
425{
426 b = 0, ///< Nter acylium ions
427 bstar = 1, ///< Nter acylium ions + NH3 loss
428 bo = 2, ///< Nter acylium ions + H2O loss
429 a = 3, ///< Nter aldimine ions
430 astar = 4, ///< Nter aldimine ions + NH3 loss
431 ao = 5, ///< Nter aldimine ions + H2O loss
432 bp = 6,
433 c = 7, ///< Nter amino ions
434 y = 8, ///< Cter amino ions
435 ystar = 9, ///< Cter amino ions + NH3 loss
436 yo = 10, ///< Cter amino ions + H2O loss
437 z = 11, ///< Cter carbocations
438 yp = 12,
439 x = 13 ///< Cter acylium ions
440};
441
442/** \brief only useful for internal use
443 * DO not change this value : it is used to define static array size
444 */
445#define PEPTIDE_ION_TYPE_COUNT 14
446} // namespace pappso
tries to keep as much as possible monoisotopes, removing any possible C13 peaks and changes multichar...
Definition: aa.cpp:39
const pappso_double MPROTON(1.007276466879)
const pappso_double ABUNDANCEC12(0.98921194185046687152862432412803173065185546875000000000000000)
PeptideIon
PeptideIon enum defines all types of ions (Nter or Cter)
Definition: types.h:425
AminoAcidChar
Definition: types.h:159
Axis
Definition: types.h:220
const pappso_double DIFFS32S33(32.9714589101 - MASSSULFUR)
PrecisionUnit
Definition: types.h:76
const pappso_double DIFFS32S34(33.9678670300 - MASSSULFUR)
MzFormat
Definition: types.h:120
@ xy
(x,y) format
@ unknown
unknown format
@ SQLite3
SQLite3 format.
@ MGF
Mascot format.
const pappso_double DIFFO16O17(16.99913150 - MASSOXYGEN)
const pappso_double MASSCARBON(12)
const pappso_double MASSPHOSPHORUS(30.973761998)
const pappso_double MASSSULFUR(31.9720711741)
const pappso_double ABUNDANCES36(0.00010999120070394368536836893213148869108408689498901367187500)
QString PeptideStr
A type definition for PeptideStr.
Definition: types.h:45
DataCompression
Definition: types.h:203
@ zlib
zlib compresssion
const pappso_double MASSCO(MASSCARBON+MASSOXYGEN)
const pappso_double ONEMILLION(1000000)
const pappso_double ABUNDANCEN15(0.00364198543205827118818262988497735932469367980957031250000000)
const pappso_double DIFFS32S36(35.9670812000 - MASSSULFUR)
const pappso_double MASSSELENIUM(79.916520)
const pappso_double MHPLUS(1.007276466879)
AtomIsotopeSurvey
Definition: types.h:89
double pappso_double
A type definition for doubles.
Definition: types.h:50
Isotope
Definition: types.h:104
AxisScale
Definition: types.h:229
SortType
Definition: types.h:186
const pappso_double ABUNDANCEC13(0.01078805814953308406245469086570665240287780761718750000000000)
const pappso_double MPROTIUM(1.007825032241)
const pappso_double MASSH2O((MPROTIUM *2)+MASSOXYGEN)
const pappso_double ABUNDANCEO17(0.00038099847600609595965615028489992255344986915588378906250000)
const pappso_double ABUNDANCEH2(0.00011570983569203332000374651045149221317842602729797363281250)
DataKind
Definition: types.h:211
@ dt
Drift time.
@ rt
Retention time.
const pappso_double MASSNH3((MPROTIUM *3)+MASSNITROGEN)
unsigned int uint
Definition: types.h:57
const pappso_double ABUNDANCES34(0.04252059835213182203972337447339668869972229003906250000000000)
const pappso_double MASSNITROGEN(14.0030740048)
const pappso_double MASSOXYGEN(15.99491461956)
const pappso_double MASSPHOSPHORYLATEDR(MPROTIUM+(MASSOXYGEN *3)+MASSPHOSPHORUS)
FileReaderType
Definition: types.h:146
const pappso_double ABUNDANCEO18(0.00205139179443282221315669744399201590567827224731445312500000)
const pappso_double DIFFO16O18(17.9991610 - MASSOXYGEN)
const pappso_double ABUNDANCES33(0.00751939844812414937003097747947322204709053039550781250000000)
const pappso_double DIFFN14N15(15.0001088982 - MASSNITROGEN)
TimeUnit
Definition: types.h:64
XicExtractMethod
Definition: types.h:240
@ sum
sum of intensities
@ max
maximum of intensities
const pappso_double DIFFC12C13(1.0033548378)
float pappso_float
Definition: types.h:55
SortOrder
Definition: types.h:194
const pappso_double DIFFH1H2(2.0141017778 - MPROTIUM)