CSCStripElectronicsSim.h

Go to the documentation of this file.

#ifndef MU_END_STRIP_ELECTRONICS_SIM_H
#define MU_END_STRIP_ELECTRONICS_SIM_H

#include "DataFormats/CSCDigi/interface/CSCComparatorDigiCollection.h"
#include "DataFormats/CSCDigi/interface/CSCStripDigiCollection.h"
#include "SimMuon/CSCDigitizer/src/CSCBaseElectronicsSim.h"
#include "SimMuon/CSCDigitizer/src/CSCStripAmpResponse.h"

class CSCDetectorHit;
class CSCComparatorDigi;
class CSCCrosstalkGenerator;
class CSCStripConditions;
#include <list>
#include <string>
#include <vector>

namespace CLHEP {
  class HepRandomEngine;
}

class CSCStripElectronicsSim : public CSCBaseElectronicsSim {
public:
  explicit CSCStripElectronicsSim(const edm::ParameterSet &p);

  ~CSCStripElectronicsSim() override;

  void fillDigis(CSCStripDigiCollection &digis, CSCComparatorDigiCollection &comparators, CLHEP::HepRandomEngine *);

  void fillMissingLayer(const CSCLayer *layer,
                        const CSCComparatorDigiCollection &comparators,
                        CSCStripDigiCollection &digis,
                        CLHEP::HepRandomEngine *);

  void setStripConditions(CSCStripConditions *cond) { theStripConditions = cond; }

  CSCAnalogSignal makeNoiseSignal(int element, CLHEP::HepRandomEngine *) override;

  void createDigi(int istrip,
                  const CSCAnalogSignal &signal,
                  std::vector<CSCStripDigi> &result,
                  CLHEP::HepRandomEngine *);

private:
  void initParameters() override;

  int readoutElement(int strip) const override;

  float calculateAmpResponse(float t) const override;
  CSCStripAmpResponse theAmpResponse;

  void runComparator(std::vector<CSCComparatorDigi> &result, CLHEP::HepRandomEngine *);

  float comparatorReading(const CSCAnalogSignal &signal, float time, CLHEP::HepRandomEngine *) const;

  // tells which strips to read out around the input strip
  void getReadoutRange(int inputStrip, int &minStrip, int &maxStrip);

  std::list<int> getKeyStrips(const std::vector<CSCComparatorDigi> &comparators) const;

  std::list<int> getKeyStripsFromMC() const;
  std::list<int> channelsToRead(const std::list<int> &keyStrips, int window) const;

  void fillStripDigis(const std::list<int> &keyStrips, CSCStripDigiCollection &digis, CLHEP::HepRandomEngine *);

  void addCrosstalk(CLHEP::HepRandomEngine *);
  void addCrosstalk(const CSCAnalogSignal &signal, int thisStrip, int otherStrip, CLHEP::HepRandomEngine *);

  void selfTest() const;

  // saturation of the 12-bit ADC.  Max reading is 4095
  void doSaturation(CSCStripDigi &digi);

  // useful constants
  float theComparatorThreshold;  // in fC
  float theComparatorNoise;
  float theComparatorRMSOffset;
  // note that we don't implement the effect of the x3.5 amplifier
  float theComparatorSaturation;
  // all of these times are in nanoseconds
  float theComparatorWait;
  float theComparatorDeadTime;
  float theDaqDeadTime;
  // save the calculation of time-of-flight+drift+shaping
  float theTimingOffset;

  int nScaBins_;
  bool doSuppression_;
  bool doCrosstalk_;
  CSCStripConditions *theStripConditions;
  CSCCrosstalkGenerator *theCrosstalkGenerator;

  int theComparatorClockJump;
  // the length of each SCA time bin, in ns.  50 by default
  float sca_time_bin_size;
  // the SCA bin which holds the peak signal.  4, by default.
  // that's really the 5th, since We start counting at 0
  int sca_peak_bin;
  // which time bin the trigger crossing goes in
  double theComparatorTimeBinOffset;
  // to center comparator signals
  double theComparatorTimeOffset;
  double theComparatorSamplingTime;
  // tweaks the timing of the SCA
  std::vector<double> theSCATimingOffsets;
  // remeber toe TOF correction in comparators,
  // so we can undo it for SCA
  float theAverageTimeOfFlight;
};

#endif