CbmMvdSensor.h

Go to the documentation of this file.

/* Copyright (C) 2014-2025 Institut fuer Kernphysik, Goethe-Universitaet Frankfurt, Frankfurt
   SPDX-License-Identifier: GPL-3.0-only
   Authors: Michael Deveaux, Philipp Sitzmann [committer] */
 
// -------------------------------------------------------------------------
// -----                      CbmMvdSensor header file                -----
// -----                  Created 02/12/08  by M. Deveaux             -----
// -------------------------------------------------------------------------
 

 
 
#ifndef CBMMVDSENSOR_H
#define CBMMVDSENSOR_H 1
 
#include "CbmMvdSensorDataSheet.h"  // for CbmMvdSensorDataSheet
#include "CbmMvdSensorPlugin.h"     // for CbmMvdSensorPlugin
 
#include <Rtypes.h>      // for ClassDef
#include <RtypesCore.h>  // for Int_t, Double_t, Float_t, UInt_t
#include <TGeoBBox.h>    // for TGeoBBox
#include <TNamed.h>      // for TNamed
#include <TObjArray.h>   // for TObjArray
#include <TString.h>     // for TString
 
#include <map>     // for map
#include <string>  // for string
 
class TBuffer;
class TClass;
class TClonesArray;
class TGeoHMatrix;
class TMemberInspector;
class TObject;
class TH1;
 
class CbmMvdSensor : public TNamed {
 
 public:
  CbmMvdSensor();
 
 
  CbmMvdSensor(const char* name, CbmMvdSensorDataSheet* dataSheet, TString volName, TString nodeName, Int_t sensorNr,
               Int_t volume, Double_t sensorStartTime);
 

  virtual ~CbmMvdSensor();
 

  uint32_t GetAddress() const { return fAddress; }
  Int_t GetStationNr() const { return fStationNr; }
  Int_t GetVolumeId() const { return fVolumeId; }
  Int_t GetDetectorID() const { return fAddress; };  // TODO: remove detectorID (use fAddress instead)
  Int_t GetSensorNr() const { return fSensorNr; }
 
  Double_t GetDX() const { return fShape->GetDX(); };
  Double_t GetDY() const { return fShape->GetDY(); };
  Double_t GetDZ() const { return fShape->GetDZ(); };
  Double_t GetX() const { return fSensorPosition[0]; };  // returns x position for pixle 0/0
  Double_t GetY() const { return fSensorPosition[1]; };  // returns y position for pixle 0/0
  Double_t GetZ() const { return fSensorPosition[2]; };  // returns z position
  Double_t GetIntegrationtime() const { return fSensorData->GetIntegrationTime(); };
  Double_t GetCurrentEventTime() const { return fcurrentEventTime; };
  Double_t GetReadoutTime(Double_t absoluteTime) const;
 
  TString GetNodeName() { return fNodeName; };
  CbmMvdSensorDataSheet* GetDataSheet() { return fSensorData; }

  void SetAddress(uint32_t address) { fAddress = address; }
  void SetDataSheet(CbmMvdSensorDataSheet* sheet) { fSensorData = sheet; }
  void SetMap(std::map<Int_t, Int_t> SensorMap) { fSensorMap = SensorMap; }  // Get Sensor Map to identify every Sensor
                                                                             /*
  //void SendInput(CbmMvdPoint* point);
  void SendInputDigi(CbmMvdDigi* digi);
  void SendInputDigiToHit(CbmMvdDigi* digi);
  void SendInputCluster(CbmMvdCluster* cluster);
*/
  void SetStation(Int_t StationNumber) { fStationNr = StationNumber; }
  void SendInputToPlugin(Int_t nPlugin, TObject* input);
 

  void LocalToTop(Double_t* local, Double_t* lab);
  void TopToLocal(Double_t* lab, Double_t* local);
  void LocalToPixel(Double_t* local, Int_t& pixelNumberX, Int_t& pixelNumberY);
  void PixelToLocal(Int_t pixelNumberX, Int_t pixelNumberY, Double_t* local);
  void PixelToTop(Int_t pixelNumberX, Int_t pixelNumberY, Double_t* lab);
  void TopToPixel(Double_t* lab, Int_t& pixelNumberX, Int_t& pixelNumberY);
 
  Int_t GetFrameNumber(Double_t absoluteTime, Int_t pixelNumberY = 0) const;
 
  Double_t GetFrameStartTime(Int_t frameNumber);
  Double_t GetFrameEndTime(Int_t frameNumber) { return GetFrameStartTime(frameNumber + 1); }
 
  Int_t GetDigiPlugin() const { return fDigiPlugin; };
  Int_t GetHitPlugin() const { return fHitPlugin; };
  Int_t GetClusterPlugin() const { return fClusterPlugin; }
  TObjArray* GetPluginArray() { return fPluginArray; }
  UInt_t GetPluginArraySize()
  {
    if (fPluginArray) { return fPluginArray->GetEntriesFast(); }
    else
      return 0;
  }
 
  Double_t ComputeIndecatedAnalogTime(Double_t hitMCTime, Float_t diodeCharge);
  Double_t ComputeEndOfBusyTime(Double_t hitMCTime, Float_t diodeCharge, Int_t pixelNumberY);
 
 
  void SetDigiPlugin(const Int_t& nPlugin) { fDigiPlugin = nPlugin; };
  void SetHitPlugin(const Int_t& nPlugin) { fHitPlugin = nPlugin; };
  void SetClusterPlugin(const Int_t& nPlugin) { fClusterPlugin = nPlugin; }
 
  void SetAlignment(TGeoHMatrix* alignmentMatrix);
  TGeoHMatrix* GetAlignmentCorr() { return fAlignmentCorr; };
  TGeoHMatrix* GetRecoMatrix() { return fRecoMatrix; };
 

  void ReadSensorGeometry(TString nodeName);
 
  void Init();
  void ShowDebugHistos();
 
  void SetPluginList(TObjArray* pluginArray) { fPluginArray = pluginArray; };
 
  void AddPlugin(CbmMvdSensorPlugin* plugin) { fPluginArray->AddLast((TObject*) plugin); };
 
  CbmMvdSensorPlugin* GetPlugin(UInt_t nPlugin) { return (CbmMvdSensorPlugin*) fPluginArray->At(nPlugin); }
 
  void SetMisalignment(Float_t misalignment[3])
  {
    for (Int_t i = 0; i < 3; i++)
      epsilon[i] = misalignment[i];
  }

  virtual void Print(Option_t* opt = "") const;
  std::string ToString() const;
 
 
  void ExecChain();           //runs chain of plugins
  void Exec(UInt_t nPlugin);  //runs individual plugin
  void ExecTo(UInt_t nPlugin);
  void ExecFrom(UInt_t nPlugin);
  void Finish();

 
  void ClearInputArray() { ; }
 
  TClonesArray* GetOutputBuffer() const;
  TClonesArray* GetOutputArray(Int_t nPlugin) const;
  TClonesArray* GetMatchArray(Int_t nPlugin) const;
  Int_t GetOutputArrayLen(Int_t nPlugin) const;
  TH1* GetHistogram(UInt_t nPlugin, UInt_t nHisto);
  UInt_t GetNumberOfHistograms(UInt_t nPlugin);
 
protected:
 Int_t fStationNr;  // Station identifier   // TODO: re-define from fAddress
 Int_t fSensorNr;   // Sensor identifier
 Int_t fVolumeId;   // MC unique volume ID
 Int_t fDigiPlugin;
 Int_t fHitPlugin;
 Int_t fDigiLen;
 Int_t fClusterPlugin;
 uint32_t fAddress;  // Address of the sensor (bits 0-12 of CbmMvdAddress)
 TString fVolName;   // Name of the volume attached to this sensor
 TString fNodeName;  // full name of the volume (including path) of the volume
 Double_t fcurrentEventTime;
 Float_t epsilon[3];
 

 TGeoBBox* fShape;             // volume corresponding to the sensor in the TGeoManager
 TGeoHMatrix* fMCMatrix;       // coordinate transformation from Master to MC-Position of this volume
 TGeoHMatrix* fRecoMatrix;     // The reconstructed position of the sensor
 TGeoHMatrix* fAlignmentCorr;  // Correction of the sensor position according to alignment
 Double_t fTempCoordinate[3];  // Just a vector to buffer temporarily position data.
 Double_t fSensorPosition[3];

 CbmMvdSensorDataSheet* fSensorData;
 std::map<Int_t, Int_t> fSensorMap;

 TObjArray* fPluginArray;

 
 Double_t fSensorStartTime;  // Defines the start time of the sensor
                             // as expressed according to CBM time stamps
                             // Unit: [s]
 
 Bool_t initialized;
 
private:
  CbmMvdSensor(const CbmMvdSensor&);
  CbmMvdSensor operator=(const CbmMvdSensor&);
 
  ClassDef(CbmMvdSensor, 2);
};
 
 
#endif