QwEventBuffer.h

Go to the documentation of this file.

 
/*!
 * \file   QwEventBuffer.h
 * \brief  Event buffer management for reading and processing CODA data
 * \author P. M. King
 * \date   2008-07-22
 */
 
#pragma once
 
#include <string>
#include <vector>
#include "Rtypes.h"
#include "TString.h"
#include "TStopwatch.h"
 
#include "THaCodaData.h"
 
#include "MQwCodaControlEvent.h"
#include "QwParameterFile.h"
 
#include <unordered_map>
 
#include "VEventDecoder.h"
#include "Coda3EventDecoder.h"
#include "Coda2EventDecoder.h"
 
class QwOptions;
class QwEPICSEvent;
class VQwSubsystem;
class QwSubsystemArray;
 
//////////////////////////////////////////////////////////////////////
 
 
/**
 * \class QwEventBuffer
 * \ingroup QwAnalysis
 * \brief Event buffer management for reading and processing CODA data
 *
 * Manages the reading of CODA event data files, including support for
 * segmented files, run lists, and event stream processing. Handles
 * event decoding via pluggable decoder classes and provides iteration
 * over events and runs.
 */
class QwEventBuffer {
 public:
  static void DefineOptions(QwOptions &options);
  static void SetDefaultDataDirectory(const std::string& dir) {
    fDefaultDataDirectory = dir;
  }
  static void SetDefaultDataFileStem(const std::string& stem) {
    fDefaultDataFileStem = stem;
  }
  static void SetDefaultDataFileExtension(const std::string& extension) {
    fDefaultDataFileExtension = extension;
  }
 
 public:
  static const Int_t kRunNotSegmented;
  static const Int_t kNoNextDataFile;
  static const Int_t kFileHandleNotConfigured;
 
  static const UInt_t kNullDataWord;
 
 
 
 public:
  QwEventBuffer();
  virtual ~QwEventBuffer() {
    // Delete event stream
    if (fEvStream != NULL) {
      delete fEvStream;
      fEvStream = NULL;
    }
      // Delete Decoder
      if(decoder != NULL) {
            delete decoder;
            decoder = NULL;
      }
  };
 
  /// \brief Sets internal flags based on the QwOptions
  void ProcessOptions(QwOptions &options);
 
  void PrintRunTimes();
 
  /// \brief Returns a string like <run#> or <run#>.<file#>
  TString GetRunLabel() const;
  /// \brief Return true if file segments are being separated for
  //analysis
  Bool_t AreRunletsSplit() const   {
    return (fRunIsSegmented && !fChainDataFiles);
  };
  /// \brief Return CODA file run number
  Int_t GetRunNumber() const {return fCurrentRun;};
  /// \brief Return CODA file segment number
  Int_t GetSegmentNumber() const {
    return fRunSegments.size() ? *fRunSegmentIterator : 0;
  };
 
  std::pair<UInt_t, UInt_t> GetEventRange() const {
    return fEventRange;
  };
 
  /// \brief Opens the event stream (file or ET) based on the internal flags
  Int_t OpenNextStream();
  /// \brief Closes a currently open event stream.
  Int_t CloseStream();
 
  void    SetDataDirectory(const TString datadir){fDataDirectory = datadir;}
 
 
  const TString&  GetDataFile() const {return fDataFile;};
  const TString&  GetDataDirectory() const {return fDataDirectory;};
 
  Int_t ReOpenStream();
 
  Int_t OpenDataFile(UInt_t current_run, Short_t seg);
  Int_t OpenDataFile(UInt_t current_run, const TString rw = "R");
  Int_t OpenDataFile(const TString filename, const TString rw = "R");
  Int_t CloseDataFile();
 
  Int_t OpenETStream(TString computer, TString session, int mode, const TString stationname="");
  Int_t CloseETStream();
 
  Bool_t IsPhysicsEvent() {
        return ( decoder->IsPhysicsEvent() );
  };
 
  Int_t GetPhysicsEventNumber() {return fNumPhysicsEvents;};
  Int_t GetEventNumber() { return decoder->GetEvtNumber(); };
 
  Bool_t GetNextEventRange();
  Bool_t GetNextRunRange();
  Bool_t GetNextRunNumber();
    void VerifyCodaVersion( const UInt_t *buffer);
 
  Int_t GetNextEvent();
 
  Int_t  GetEvent();
  Int_t  WriteEvent(int* buffer);
 
  Bool_t IsOnline(){return fOnline;};
 
  Bool_t IsROCConfigurationEvent(){
    return ( decoder->IsROCConfigurationEvent() );
  };
 
  Bool_t IsEPICSEvent(){
    return ( decoder->IsEPICSEvent() ); // Defined in CodaDecoder.h
    }
 
  Bool_t FillSubsystemConfigurationData(QwSubsystemArray &subsystems);
  Bool_t FillSubsystemData(QwSubsystemArray &subsystems);
 
  Bool_t FillEPICSData(QwEPICSEvent &epics);
 
  template < class T > Bool_t FillObjectWithEventData(T &t);
 
 
  void ResetControlParameters();
    void ReportRunSummary();
  Int_t EncodeSubsystemData(QwSubsystemArray &subsystems);
  Int_t EncodePrestartEvent(int runnumber, int runtype = 0);
  Int_t EncodeGoEvent();
  Int_t EncodePauseEvent();
  Int_t EncodeEndEvent();
 
    TString GetStartSQLTime();
    TString GetEndSQLTime();
    time_t  GetStartUnixTime();
    time_t  GetEndUnixTime();
 
  void ResetFlags();
 
 private:
  //  These methods will be removed from a future version
  void ClearEventData(std::vector<VQwSubsystem*> &subsystems);
 
  Bool_t FillSubsystemConfigurationData(std::vector<VQwSubsystem*> &subsystems);
  Bool_t FillSubsystemData(std::vector<VQwSubsystem*> &subsystems);
    
    // Coda Version that is set by void VerifyCodaVersion( ) 
    // Compared against the user-input coda version
    Int_t fDataVersionVerify = 0;
  Int_t fDataVersion; // User-input Coda Version    
 
 protected:
  ///
  Bool_t fOnline;
  TString fETHostname;
  TString fETSession;
  TString fETStationName;
  Int_t   fETWaitMode;
  Bool_t  fExitOnEnd;
 
 
  Bool_t fChainDataFiles;
  std::pair<Int_t, Int_t> fRunRange;
  std::string fRunListFileName;
  std::unique_ptr<QwParameterFile> fRunListFile;
  std::vector<Int_t> fRunRangeMinList, fRunRangeMaxList;
 
  std::pair<UInt_t, UInt_t> fEventRange;
  std::string fEventListFileName;
  std::unique_ptr<QwParameterFile> fEventListFile;
  std::vector<UInt_t> fEventList;
 
  std::pair<Int_t, Int_t> fSegmentRange;
 
 protected:
 
  static std::string fDefaultDataDirectory;
  static std::string fDefaultDataFileStem;
  static std::string fDefaultDataFileExtension;
 
  TString fDataFileStem;
  TString fDataFileExtension;
 
  TString fDataDirectory;
  TString fDataFile;
 
  // UInt_t fRunNumber;
 
 
 protected:
  Int_t  GetFileEvent();
  Int_t  GetEtEvent();
 
  Int_t WriteFileEvent(int* buffer);
 
  Bool_t DataFileIsSegmented();
 
  Int_t CloseThisSegment();
  Int_t OpenNextSegment();
 
  const TString&  DataFile(const UInt_t run, const Short_t seg);
 
  //  void SetEventLength(const ULong_t tmplength) {fEvtLength = tmplength;};
  //  void SetEventType(const UInt_t tmptype) {fEvtType = tmptype;};
  //  void SetWordsSoFar(const ULong_t tmpwords) {fWordsSoFar = tmpwords;};
 
 
 
 protected:
  enum CodaStreamMode{fEvStreamNull, fEvStreamFile, fEvStreamET} fEvStreamMode;
  THaCodaData *fEvStream; //  Pointer to a THaCodaFile or THaEtClient
 
  Int_t fCurrentRun;
 
  Bool_t fRunIsSegmented;
 
 
  std::vector<Int_t>           fRunSegments;
  std::vector<Int_t>::iterator fRunSegmentIterator;
 
 
 protected:
  Double_t fCleanParameter[3]; ///< Scan data/clean data from the green monster
 
 
  TStopwatch fRunTimer;      ///<  Timer used for runlet processing loop
  TStopwatch fStopwatch;     ///<  Timer used for internal timing
 
 protected:
  ///  Methods and data members needed to find marker words
  typedef ULong64_t RocBankLabel_t;
  std::unordered_map<RocBankLabel_t, std::vector<UInt_t> > fMarkerList;
  std::unordered_map<RocBankLabel_t, std::vector<UInt_t> > fOffsetList;
 
  std::size_t CheckForMarkerWords(QwSubsystemArray &subsystems);
  RocBankLabel_t fThisRocBankLabel;
  UInt_t FindMarkerWord(UInt_t markerID, UInt_t* buffer, UInt_t num_words);
  UInt_t GetMarkerWord(UInt_t markerID);
 
 protected:
  UInt_t     fNumPhysicsEvents;
  UInt_t     fStartingPhysicsEvent;
 
  Bool_t fSingleFile;
 
 protected:
    VEventDecoder* decoder;
};
 
template < class T > Bool_t QwEventBuffer::FillObjectWithEventData(T &object){
  ///  Template to fill any object with data from a CODA event.
  ///
  ///  The classes for which this template can be specialized
  ///  must have the following three methods defined:
  ///
  ///  - Bool_t T::CanUseThisEventType(const UInt_t event_type);
  ///  - Bool_t T::ClearEventData(const UInt_t event_type);
  ///  - Int_t  T::ProcessBuffer(const UInt_t event_type,
  ///       const ROCID_t roc_id, const BankID_t bank_id, 
  ///       const UInt_t banktype, UInt_t* buffer, UInt_t num_words);
  ///
  Bool_t okay = kFALSE;
  UInt_t *localbuff = (UInt_t*)(fEvStream->getEvBuffer());
 
  if (decoder->GetFragLength()==1 && localbuff[decoder->GetWordsSoFar()]==kNullDataWord){
    decoder->AddWordsSoFarAndFragLength();
  } else if (object.CanUseThisEventType(decoder->GetEvtType())){
    //  Clear the old event information from the object
    object.ClearEventData(decoder->GetEvtType());
    //  Loop through the data buffer in this event.
    if (decoder->GetBankDataType() == 0x10){
      //  This bank is subbanked; loop through subbanks
      while ((okay = decoder->DecodeSubbankHeader(&localbuff[decoder->GetWordsSoFar()]))){
    //  If this bank has further subbanks, restart the loop.
    if (decoder->GetSubbankType() == 0x10) continue;
    //  If this bank only contains the word 'NULL' then skip
    //  this bank.
    if (decoder->GetFragLength()==1 && localbuff[decoder->GetWordsSoFar()]==kNullDataWord){
      decoder->AddWordsSoFarAndFragLength();
      continue;
    }
    object.ProcessBuffer(decoder->GetEvtType(), decoder->GetROC(), decoder->GetSubbankTag(), decoder->GetSubbankType(),
                 &localbuff[decoder->GetWordsSoFar()],
                 decoder->GetFragLength());
    decoder->AddWordsSoFarAndFragLength();
      }
    } else {
      //  This is a single bank of some type
      object.ProcessBuffer(decoder->GetEvtType(), 0, decoder->GetBankDataType(),
               &localbuff[decoder->GetWordsSoFar()],
               decoder->GetEvtLength());
    }
  }
  return okay;
}