libpappsomspp
Library for mass spectrometry
pappso::TimsMsRunReaderMs2 Class Reference

#include <timsmsrunreaderms2.h>

Inheritance diagram for pappso::TimsMsRunReaderMs2:
pappso::MsRunReader pappso::TimsMsRunReaderMs2Selected

Public Member Functions

 TimsMsRunReaderMs2 (MsRunIdCstSPtr &msrun_id_csp)
 
virtual ~TimsMsRunReaderMs2 ()
 
virtual MassSpectrumSPtr massSpectrumSPtr (std::size_t spectrum_index) override
 get a MassSpectrumSPtr class given its spectrum index More...
 
virtual MassSpectrumCstSPtr massSpectrumCstSPtr (std::size_t spectrum_index) override
 
virtual QualifiedMassSpectrum qualifiedMassSpectrum (std::size_t spectrum_index, bool want_binary_data=true) const override
 get a QualifiedMassSpectrum class given its scan number More...
 
virtual void readSpectrumCollection (SpectrumCollectionHandlerInterface &handler) override
 function to visit an MsRunReader and get each Spectrum in a spectrum collection handler More...
 
virtual pappso::XicCoordSPtr newXicCoordSPtrFromSpectrumIndex (std::size_t spectrum_index, pappso::PrecisionPtr precision) const override
 get a xic coordinate object from a given spectrum index More...
 
virtual pappso::XicCoordSPtr newXicCoordSPtrFromQualifiedMassSpectrum (const pappso::QualifiedMassSpectrum &mass_spectrum, pappso::PrecisionPtr precision) const override
 get a xic coordinate object from a given spectrum More...
 
virtual void readSpectrumCollectionByMsLevel (SpectrumCollectionHandlerInterface &handler, unsigned int ms_level) override
 function to visit an MsRunReader and get each Spectrum in a spectrum collection handler by Ms Levels More...
 
virtual std::size_t spectrumListSize () const override
 get the totat number of spectrum conained in the MSrun data file More...
 
virtual bool hasScanNumbers () const override
 tells if spectra can be accessed using scan numbers by default, it returns false. Only overrided functions can check if scan numbers are available in the current file More...
 
void setMs2FilterCstSPtr (pappso::FilterInterfaceCstSPtr filter)
 
void setMs1FilterCstSPtr (pappso::FilterInterfaceCstSPtr filter)
 
void setMs2BuiltinCentroid (bool centroid)
 enable or disable simple centroid filter on raw tims data for MS2 More...
 
virtual std::vector< std::size_t > getPrecursorsIDFromMzRt (int charge, double mz_val, double rt_sec, double k0)
 Get all the precursors id which match the values. More...
 
virtual bool releaseDevice () override
 release data back end device if a the data back end is released, the developper has to use acquireDevice before using the msrunreader object More...
 
virtual bool acquireDevice () override
 acquire data back end device More...
 
virtual TimsDataSp getTimsDataSPtr ()
 give an access to the underlying raw data pointer More...
 
virtual std::vector< double > getRetentionTimeLine () override
 retention timeline get retention times along the MSrun in seconds More...
 
- Public Member Functions inherited from pappso::MsRunReader
 MsRunReader (MsRunIdCstSPtr &ms_run_id)
 
 MsRunReader (const MsRunReader &other)
 
virtual ~MsRunReader ()
 
const MsRunIdCstSPtrgetMsRunId () const
 
virtual std::size_t scanNumber2SpectrumIndex (std::size_t scan_number)
 if possible, converts a scan number into a spectrum index This is a convenient function to help transition from the old scan number (not implemented by all vendors) to more secure spectrum index (not vendor dependant). It is better to not rely on this function. More...
 

Protected Member Functions

virtual void initialize () override
 
virtual bool accept (const QString &file_name) const override
 tells if the reader is able to handle this file must be implemented by private MS run reader, specific of one or more file format More...
 

Private Attributes

TimsDataSp msp_timsData = nullptr
 
pappso::FilterInterfaceCstSPtr msp_ms1Filter
 
pappso::FilterInterfaceCstSPtr msp_ms2Filter
 
bool m_builtinMs2Centroid = true
 enable builtin centroid on raw tims integers by default More...
 

Friends

class MsFileAccessor
 

Additional Inherited Members

- Protected Attributes inherited from pappso::MsRunReader
MsRunIdCstSPtr mcsp_msRunId
 
MsRunReaderScanNumberMultiMapmpa_multiMapScanNumber = nullptr
 

Detailed Description

Definition at line 40 of file timsmsrunreaderms2.h.

Constructor & Destructor Documentation

◆ TimsMsRunReaderMs2()

TimsMsRunReaderMs2::TimsMsRunReaderMs2 ( MsRunIdCstSPtr msrun_id_csp)
Todo:
write docs

Definition at line 39 of file timsmsrunreaderms2.cpp.

40  : MsRunReader(msrun_id_csp)
41 {
42  initialize();
43 }
MsRunReader(MsRunIdCstSPtr &ms_run_id)
virtual void initialize() override

References initialize().

◆ ~TimsMsRunReaderMs2()

TimsMsRunReaderMs2::~TimsMsRunReaderMs2 ( )
virtual

Definition at line 45 of file timsmsrunreaderms2.cpp.

46 {
47  if(msp_timsData != nullptr)
48  {
49  msp_timsData = nullptr;
50  }
51 }

References msp_timsData.

Member Function Documentation

◆ accept()

bool TimsMsRunReaderMs2::accept ( const QString &  file_name) const
overrideprotectedvirtual

tells if the reader is able to handle this file must be implemented by private MS run reader, specific of one or more file format

Implements pappso::MsRunReader.

Reimplemented in pappso::TimsMsRunReaderMs2Selected.

Definition at line 115 of file timsmsrunreaderms2.cpp.

116 {
117  qDebug() << file_name;
118  return true;
119 }

◆ acquireDevice()

bool TimsMsRunReaderMs2::acquireDevice ( )
overridevirtual

acquire data back end device

Returns
bool true if done

Implements pappso::MsRunReader.

Definition at line 254 of file timsmsrunreaderms2.cpp.

255 {
256  if(msp_timsData == nullptr)
257  {
258  initialize();
259  msp_timsData->setMs2BuiltinCentroid(m_builtinMs2Centroid);
260  msp_timsData->setMs1FilterCstSPtr(msp_ms1Filter);
261  msp_timsData->setMs2FilterCstSPtr(msp_ms2Filter);
262  }
263  return true;
264 }
pappso::FilterInterfaceCstSPtr msp_ms2Filter
pappso::FilterInterfaceCstSPtr msp_ms1Filter
bool m_builtinMs2Centroid
enable builtin centroid on raw tims integers by default

References initialize(), m_builtinMs2Centroid, msp_ms1Filter, msp_ms2Filter, and msp_timsData.

◆ getPrecursorsIDFromMzRt()

std::vector< std::size_t > pappso::TimsMsRunReaderMs2::getPrecursorsIDFromMzRt ( int  charge,
double  mz_val,
double  rt_sec,
double  k0 
)
virtual

Get all the precursors id which match the values.

Returns
list of precursors Ids

Definition at line 267 of file timsmsrunreaderms2.cpp.

271 {
272  return msp_timsData->getPrecursorsFromMzRtCharge(charge, mz_val, rt_sec, k0);
273 }

◆ getRetentionTimeLine()

std::vector< double > pappso::TimsMsRunReaderMs2::getRetentionTimeLine ( )
overridevirtual

retention timeline get retention times along the MSrun in seconds

Returns
vector of retention times (seconds)

Reimplemented from pappso::MsRunReader.

Definition at line 311 of file timsmsrunreaderms2.cpp.

312 {
313  return msp_timsData.get()->getRetentionTimeLine();
314 }

◆ getTimsDataSPtr()

pappso::TimsDataSp pappso::TimsMsRunReaderMs2::getTimsDataSPtr ( )
virtual

give an access to the underlying raw data pointer

Definition at line 276 of file timsmsrunreaderms2.cpp.

277 {
278  acquireDevice();
279  return msp_timsData;
280 }
virtual bool acquireDevice() override
acquire data back end device

Referenced by pappso::TimsXicExtractorInterface::TimsXicExtractorInterface().

◆ hasScanNumbers()

bool TimsMsRunReaderMs2::hasScanNumbers ( ) const
overridevirtual

tells if spectra can be accessed using scan numbers by default, it returns false. Only overrided functions can check if scan numbers are available in the current file

Reimplemented from pappso::MsRunReader.

Reimplemented in pappso::TimsMsRunReaderMs2Selected.

Definition at line 240 of file timsmsrunreaderms2.cpp.

241 {
242  return false;
243 }

◆ initialize()

void pappso::TimsMsRunReaderMs2::initialize ( )
overrideprotectedvirtual

Implements pappso::MsRunReader.

Reimplemented in pappso::TimsMsRunReaderMs2Selected.

Definition at line 54 of file timsmsrunreaderms2.cpp.

55 {
56  msp_timsData = std::make_shared<TimsData>(mcsp_msRunId.get()->getFileName());
57  if(msp_timsData == nullptr)
58  {
59  throw PappsoException(
60  QObject::tr("ERROR in TimsMsRunReaderMs2::initialize "
61  "msp_timsData is null for MsRunId %1")
62  .arg(mcsp_msRunId.get()->toString()));
63  }
64 }
MsRunIdCstSPtr mcsp_msRunId
Definition: msrunreader.h:263

Referenced by TimsMsRunReaderMs2(), and acquireDevice().

◆ massSpectrumCstSPtr()

pappso::MassSpectrumCstSPtr TimsMsRunReaderMs2::massSpectrumCstSPtr ( std::size_t  spectrum_index)
overridevirtual

Implements pappso::MsRunReader.

Reimplemented in pappso::TimsMsRunReaderMs2Selected.

Definition at line 132 of file timsmsrunreaderms2.cpp.

133 {
134  QualifiedMassSpectrum mass_spectrum =
135  qualifiedMassSpectrum(spectrum_index, true);
136  return mass_spectrum.getMassSpectrumSPtr();
137 }
Class representing a fully specified mass spectrum.
MassSpectrumSPtr getMassSpectrumSPtr() const
Get the MassSpectrumSPtr.
virtual QualifiedMassSpectrum qualifiedMassSpectrum(std::size_t spectrum_index, bool want_binary_data=true) const override
get a QualifiedMassSpectrum class given its scan number

References pappso::QualifiedMassSpectrum::getMassSpectrumSPtr(), and qualifiedMassSpectrum().

◆ massSpectrumSPtr()

pappso::MassSpectrumSPtr TimsMsRunReaderMs2::massSpectrumSPtr ( std::size_t  spectrum_index)
overridevirtual

get a MassSpectrumSPtr class given its spectrum index

Implements pappso::MsRunReader.

Reimplemented in pappso::TimsMsRunReaderMs2Selected.

Definition at line 123 of file timsmsrunreaderms2.cpp.

124 {
125  QualifiedMassSpectrum mass_spectrum =
126  qualifiedMassSpectrum(spectrum_index, true);
127  return mass_spectrum.getMassSpectrumSPtr();
128 }

References pappso::QualifiedMassSpectrum::getMassSpectrumSPtr(), and qualifiedMassSpectrum().

◆ newXicCoordSPtrFromQualifiedMassSpectrum()

pappso::XicCoordSPtr TimsMsRunReaderMs2::newXicCoordSPtrFromQualifiedMassSpectrum ( const pappso::QualifiedMassSpectrum mass_spectrum,
pappso::PrecisionPtr  precision 
) const
overridevirtual

get a xic coordinate object from a given spectrum

Implements pappso::MsRunReader.

Definition at line 302 of file timsmsrunreaderms2.cpp.

305 {
307  mass_spectrum.getMassSpectrumId().getSpectrumIndex(), precision);
308 }
std::size_t getSpectrumIndex() const
const MassSpectrumId & getMassSpectrumId() const
Get the MassSpectrumId.
virtual pappso::XicCoordSPtr newXicCoordSPtrFromSpectrumIndex(std::size_t spectrum_index, pappso::PrecisionPtr precision) const override
get a xic coordinate object from a given spectrum index

References pappso::QualifiedMassSpectrum::getMassSpectrumId(), pappso::MassSpectrumId::getSpectrumIndex(), and newXicCoordSPtrFromSpectrumIndex().

◆ newXicCoordSPtrFromSpectrumIndex()

XicCoordSPtr TimsMsRunReaderMs2::newXicCoordSPtrFromSpectrumIndex ( std::size_t  spectrum_index,
pappso::PrecisionPtr  precision 
) const
overridevirtual

get a xic coordinate object from a given spectrum index

Implements pappso::MsRunReader.

Definition at line 284 of file timsmsrunreaderms2.cpp.

286 {
287  XicCoordTimsSPtr xic_coord = std::make_shared<XicCoordTims>();
288  std::size_t precursor_index = (spectrum_index / 2) + 1;
289  auto xic = this->msp_timsData.get()->getXicCoordTimsFromPrecursorId(
290  precursor_index, precision);
291 
292  xic_coord.get()->mzRange = xic.mzRange;
293  xic_coord.get()->rtTarget = xic.rtTarget;
294  xic_coord.get()->scanNumBegin = xic.scanNumBegin;
295  xic_coord.get()->scanNumEnd = xic.scanNumEnd;
296 
297 
298  return xic_coord;
299 }
std::shared_ptr< XicCoordTims > XicCoordTimsSPtr
Definition: xiccoordtims.h:38

References msp_timsData.

Referenced by newXicCoordSPtrFromQualifiedMassSpectrum().

◆ qualifiedMassSpectrum()

QualifiedMassSpectrum TimsMsRunReaderMs2::qualifiedMassSpectrum ( std::size_t  spectrum_index,
bool  want_binary_data = true 
) const
overridevirtual

get a QualifiedMassSpectrum class given its scan number

Implements pappso::MsRunReader.

Reimplemented in pappso::TimsMsRunReaderMs2Selected.

Definition at line 141 of file timsmsrunreaderms2.cpp.

143 {
144 
145  std::size_t precursor_index = (spectrum_index / 2) + 1;
146  TimsData::SpectrumDescr spectrum_descr;
147  try
148  {
149  spectrum_descr =
150  msp_timsData.get()->getSpectrumDescrWithPrecursorId(precursor_index);
151  }
152  catch(ExceptionNotFound &error)
153  {
154  throw ExceptionNotFound(
155  QObject::tr("spectrum_index %1 NOT FOUND in file %2 : %3")
156  .arg(spectrum_index)
157  .arg(getMsRunId().get()->getFileName())
158  .arg(error.qwhat()));
159  }
160 
161  if(spectrum_index % 2 == 0)
162  {
163  qDebug() << "MS1 spectrum precursor_index=" << precursor_index;
164  // this is an MS1 spectrum
165  QualifiedMassSpectrum mass_spectrum_ms1;
166  msp_timsData->getQualifiedMs1MassSpectrumByPrecursorId(
167  getMsRunId(), mass_spectrum_ms1, spectrum_descr, want_binary_data);
168  qDebug(); // << mass_spectrum_ms1.toString();
169 
170  // qDebug() << mass_spectrum_ms1.getMassSpectrumSPtr().get()->toString();
171  return mass_spectrum_ms1;
172  }
173  else
174  {
175  qDebug() << "MS2 spectrum precursor_index=" << precursor_index;
176  QualifiedMassSpectrum mass_spectrum_ms2;
177  if(spectrum_descr.ms2_index != spectrum_index)
178  {
179  qDebug();
180  throw PappsoException(
181  QObject::tr("ERROR in %1 %2 %3 spectrum_descr.ms2_index(%4) != "
182  "spectrum_index(%5)")
183  .arg(__FILE__)
184  .arg(__FUNCTION__)
185  .arg(__LINE__)
186  .arg(spectrum_descr.ms2_index)
187  .arg(spectrum_index));
188  }
189 
190  msp_timsData->getQualifiedMs2MassSpectrumByPrecursorId(
191  getMsRunId(), mass_spectrum_ms2, spectrum_descr, want_binary_data);
192  qDebug(); // << mass_spectrum_ms2.toString();
193 
194  // qDebug() << mass_spectrum_ms2.getMassSpectrumSPtr().get()->toString();
195  return mass_spectrum_ms2;
196  }
197 }
const MsRunIdCstSPtr & getMsRunId() const
virtual const QString & qwhat() const

References pappso::MsRunReader::getMsRunId(), pappso::TimsData::SpectrumDescr::ms2_index, msp_timsData, and pappso::PappsoException::qwhat().

Referenced by massSpectrumCstSPtr(), and massSpectrumSPtr().

◆ readSpectrumCollection()

void TimsMsRunReaderMs2::readSpectrumCollection ( SpectrumCollectionHandlerInterface handler)
overridevirtual

function to visit an MsRunReader and get each Spectrum in a spectrum collection handler

Implements pappso::MsRunReader.

Reimplemented in pappso::TimsMsRunReaderMs2Selected.

Definition at line 201 of file timsmsrunreaderms2.cpp.

203 {
205 }
virtual void readSpectrumCollectionByMsLevel(SpectrumCollectionHandlerInterface &handler, unsigned int ms_level) override
function to visit an MsRunReader and get each Spectrum in a spectrum collection handler by Ms Levels

References readSpectrumCollectionByMsLevel().

◆ readSpectrumCollectionByMsLevel()

void TimsMsRunReaderMs2::readSpectrumCollectionByMsLevel ( SpectrumCollectionHandlerInterface handler,
unsigned int  ms_level 
)
overridevirtual

function to visit an MsRunReader and get each Spectrum in a spectrum collection handler by Ms Levels

Implements pappso::MsRunReader.

Definition at line 208 of file timsmsrunreaderms2.cpp.

210 {
211  qDebug() << " ms_level=" << ms_level;
212  // We'll need it to perform the looping in the spectrum list.
213  std::size_t spectrum_list_size = spectrumListSize();
214 
215  // qDebug() << "The spectrum list has size:" << spectrum_list_size;
216 
217  // Inform the handler of the spectrum list so that it can handle feedback to
218  // the user.
219  handler.spectrumListHasSize(spectrum_list_size);
220 
221  msp_timsData.get()->ms2ReaderSpectrumCollectionByMsLevel(
222  getMsRunId(), handler, ms_level);
223  // Now let the loading handler know that the loading of the data has ended.
224  // The handler might need this "signal" to perform additional tasks or to
225  // cleanup cruft.
226 
227  // qDebug() << "Loading ended";
228  handler.loadingEnded();
229 }
virtual void spectrumListHasSize(std::size_t size)
Definition: msrunreader.cpp:52
virtual std::size_t spectrumListSize() const override
get the totat number of spectrum conained in the MSrun data file

References pappso::MsRunReader::getMsRunId(), pappso::SpectrumCollectionHandlerInterface::loadingEnded(), msp_timsData, pappso::SpectrumCollectionHandlerInterface::spectrumListHasSize(), and spectrumListSize().

Referenced by readSpectrumCollection().

◆ releaseDevice()

bool TimsMsRunReaderMs2::releaseDevice ( )
overridevirtual

release data back end device if a the data back end is released, the developper has to use acquireDevice before using the msrunreader object

Returns
bool true if done

Implements pappso::MsRunReader.

Definition at line 247 of file timsmsrunreaderms2.cpp.

248 {
249  msp_timsData = nullptr;
250  return true;
251 }

References msp_timsData.

◆ setMs1FilterCstSPtr()

void TimsMsRunReaderMs2::setMs1FilterCstSPtr ( pappso::FilterInterfaceCstSPtr  filter)

Definition at line 99 of file timsmsrunreaderms2.cpp.

100 {
101  msp_ms1Filter = filter;
102  if(msp_timsData != nullptr)
103  {
104  msp_timsData->setMs1FilterCstSPtr(filter);
105  }
106  else
107  {
108  throw PappsoException(
109  QObject::tr("ERROR in TimsMsRunReaderMs2::setMs1FilterCstSPtr "
110  "msp_timsData is null"));
111  }
112 }

References msp_ms1Filter, and msp_timsData.

◆ setMs2BuiltinCentroid()

void TimsMsRunReaderMs2::setMs2BuiltinCentroid ( bool  centroid)

enable or disable simple centroid filter on raw tims data for MS2

Definition at line 67 of file timsmsrunreaderms2.cpp.

68 {
69  m_builtinMs2Centroid = centroid;
70  if(msp_timsData != nullptr)
71  {
72  msp_timsData->setMs2BuiltinCentroid(m_builtinMs2Centroid);
73  }
74  else
75  {
76  throw PappsoException(
77  QObject::tr("ERROR in TimsMsRunReaderMs2::setMs2BuiltinCentroid "
78  "msp_timsData is null"));
79  }
80 }

References m_builtinMs2Centroid, and msp_timsData.

Referenced by pappso::TandemWrapperRun::convertOrginalMsData2mzXmlData().

◆ setMs2FilterCstSPtr()

void TimsMsRunReaderMs2::setMs2FilterCstSPtr ( pappso::FilterInterfaceCstSPtr  filter)

Definition at line 83 of file timsmsrunreaderms2.cpp.

84 {
85  msp_ms2Filter = filter;
86  if(msp_timsData != nullptr)
87  {
88  msp_timsData->setMs2FilterCstSPtr(msp_ms2Filter);
89  }
90  else
91  {
92  throw PappsoException(
93  QObject::tr("ERROR in TimsMsRunReaderMs2::setMs2FilterCstSPtr "
94  "msp_timsData is null"));
95  }
96 }

References msp_ms2Filter, and msp_timsData.

Referenced by pappso::TandemWrapperRun::convertOrginalMsData2mzXmlData().

◆ spectrumListSize()

std::size_t TimsMsRunReaderMs2::spectrumListSize ( ) const
overridevirtual

get the totat number of spectrum conained in the MSrun data file

Implements pappso::MsRunReader.

Reimplemented in pappso::TimsMsRunReaderMs2Selected.

Definition at line 233 of file timsmsrunreaderms2.cpp.

234 {
235  return (msp_timsData->getTotalNumberOfPrecursors() * 2);
236 }

References msp_timsData.

Referenced by readSpectrumCollectionByMsLevel().

Friends And Related Function Documentation

◆ MsFileAccessor

friend class MsFileAccessor
friend

Definition at line 42 of file timsmsrunreaderms2.h.

Member Data Documentation

◆ m_builtinMs2Centroid

bool pappso::TimsMsRunReaderMs2::m_builtinMs2Centroid = true
private

enable builtin centroid on raw tims integers by default

Definition at line 119 of file timsmsrunreaderms2.h.

Referenced by acquireDevice(), and setMs2BuiltinCentroid().

◆ msp_ms1Filter

pappso::FilterInterfaceCstSPtr pappso::TimsMsRunReaderMs2::msp_ms1Filter
private

Definition at line 115 of file timsmsrunreaderms2.h.

Referenced by acquireDevice(), and setMs1FilterCstSPtr().

◆ msp_ms2Filter

pappso::FilterInterfaceCstSPtr pappso::TimsMsRunReaderMs2::msp_ms2Filter
private

Definition at line 116 of file timsmsrunreaderms2.h.

Referenced by acquireDevice(), and setMs2FilterCstSPtr().

◆ msp_timsData


The documentation for this class was generated from the following files: