CaloTDigitizer< Traits, runHelper > Class Template Reference

#include <CaloTDigitizer.h>

Public Types
typedef Traits::Digi	Digi
typedef Traits::DigiCollection	DigiCollection
typedef Traits::ElectronicsSim	ElectronicsSim

Public Member Functions
void	add (const std::vector< PCaloHit > &hits, int bunchCrossing, CLHEP::HepRandomEngine *engine)
void	addNoiseSignals (CLHEP::HepRandomEngine *engine)
	CaloTDigitizer (CaloHitResponse *hitResponse, ElectronicsSim *electronicsSim, bool addNoise)
const std::vector< DetId > &	detIds () const
	tell the digitizer which cells exist More...
const CaloSamplesCollection &	getCaloSamples () const
void	initializeHits ()
void	run (DigiCollection &output, CLHEP::HepRandomEngine *engine)
	Collects the digis. More...
void	run (MixCollection< PCaloHit > &, DigiCollection &)
	turns hits into digis More...
void	setDebugCaloSamples (bool debug)
void	setDetIds (const std::vector< DetId > &detIds)
void	setNoiseSignalGenerator (CaloVNoiseSignalGenerator *generator)
	~CaloTDigitizer ()
	doesn't delete the pointers passed in More...

Private Attributes
bool	addNoise_
CaloSamplesCollection	csColl_
bool	debugCS_
runHelper< Traits >	runAnalogToDigital
const std::vector< DetId > *	theDetIds
ElectronicsSim *	theElectronicsSim
CaloHitResponse *	theHitResponse
CaloVNoiseSignalGenerator *	theNoiseSignalGenerator

Detailed Description

template<class Traits, template< class > class runHelper = CaloTDigitizerDefaultRun>
class CaloTDigitizer< Traits, runHelper >

Definition at line 42 of file CaloTDigitizer.h.

Member Typedef Documentation

Digi

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

typedef Traits::Digi CaloTDigitizer< Traits, runHelper >::Digi

Definition at line 48 of file CaloTDigitizer.h.

DigiCollection

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

typedef Traits::DigiCollection CaloTDigitizer< Traits, runHelper >::DigiCollection

Definition at line 49 of file CaloTDigitizer.h.

ElectronicsSim

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

typedef Traits::ElectronicsSim CaloTDigitizer< Traits, runHelper >::ElectronicsSim

these are the types that need to be defined in the Traits class. The ElectronicsSim needs to have an interface that you'll see in the run() method

Definition at line 47 of file CaloTDigitizer.h.

Constructor & Destructor Documentation

CaloTDigitizer()

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

CaloTDigitizer< Traits, runHelper >::CaloTDigitizer ( CaloHitResponse *  hitResponse, ElectronicsSim *  electronicsSim, bool  addNoise  )

inline

Definition at line 51 of file CaloTDigitizer.h.

      : theHitResponse(hitResponse),
        theNoiseSignalGenerator(nullptr),
        theElectronicsSim(electronicsSim),
        theDetIds(nullptr),
        addNoise_(addNoise),
        debugCS_(false) {}

~CaloTDigitizer()

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

CaloTDigitizer< Traits, runHelper >::~CaloTDigitizer ( )

inline

doesn't delete the pointers passed in

Definition at line 60 of file CaloTDigitizer.h.

{}

Member Function Documentation

add()

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

void CaloTDigitizer< Traits, runHelper >::add ( const std::vector< PCaloHit > &  hits, int  bunchCrossing, CLHEP::HepRandomEngine *  engine  )

inline

Definition at line 75 of file CaloTDigitizer.h.

                                                                                             {
    if (theHitResponse->withinBunchRange(bunchCrossing)) {
      for (std::vector<PCaloHit>::const_iterator it = hits.begin(), itEnd = hits.end(); it != itEnd; ++it) {
        theHitResponse->add(*it, engine);
      }
    }
  }

References CaloHitResponse::add(), hfClusterShapes_cfi::hits, CaloTDigitizer< Traits, runHelper >::theHitResponse, and CaloHitResponse::withinBunchRange().

Referenced by CastorDigiProducer::accumulateCaloHits(), HcalTBDigiProducer::accumulateCaloHits(), and counter.Counter::register().

addNoiseSignals()

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

void CaloTDigitizer< Traits, runHelper >::addNoiseSignals ( CLHEP::HepRandomEngine *  engine )

inline

Definition at line 134 of file CaloTDigitizer.h.

                                                     {
    std::vector<CaloSamples> noiseSignals;
    // noise signals need to be in units of photoelectrons.  Fractional is OK
    theNoiseSignalGenerator->fillEvent(engine);
    theNoiseSignalGenerator->getNoiseSignals(noiseSignals);
    for (std::vector<CaloSamples>::const_iterator signalItr = noiseSignals.begin(), signalEnd = noiseSignals.end();
         signalItr != signalEnd;
         ++signalItr) {
      theHitResponse->add(*signalItr);
    }
  }

References CaloHitResponse::add(), CaloVNoiseSignalGenerator::fillEvent(), CaloVNoiseSignalGenerator::getNoiseSignals(), CaloTDigitizer< Traits, runHelper >::theHitResponse, and CaloTDigitizer< Traits, runHelper >::theNoiseSignalGenerator.

Referenced by CaloTDigitizer< Traits, runHelper >::run().

detIds()

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

const std::vector<DetId>& CaloTDigitizer< Traits, runHelper >::detIds ( void  ) const

inline

tell the digitizer which cells exist

Definition at line 63 of file CaloTDigitizer.h.

                                         {
    assert(0 != theDetIds);
    return *theDetIds;
  }

References cms::cuda::assert(), and CaloTDigitizer< Traits, runHelper >::theDetIds.

Referenced by CaloTDigitizer< Traits, runHelper >::setDetIds().

getCaloSamples()

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

const CaloSamplesCollection& CaloTDigitizer< Traits, runHelper >::getCaloSamples ( ) const

inline

Definition at line 73 of file CaloTDigitizer.h.

{ return csColl_; }

References CaloTDigitizer< Traits, runHelper >::csColl_.

initializeHits()

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

void CaloTDigitizer< Traits, runHelper >::initializeHits ( )

inline

Definition at line 83 of file CaloTDigitizer.h.

{ theHitResponse->initializeHits(); }

References CaloHitResponse::initializeHits(), and CaloTDigitizer< Traits, runHelper >::theHitResponse.

Referenced by CastorDigiProducer::initializeEvent(), and HcalTBDigiProducer::initializeEvent().

run() [1/2]

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

void CaloTDigitizer< Traits, runHelper >::run ( DigiCollection &  output, CLHEP::HepRandomEngine *  engine  )

inline

Collects the digis.

Definition at line 90 of file CaloTDigitizer.h.

                                                                 {
    assert(!theDetIds->empty());
 
    if (theNoiseSignalGenerator != nullptr)
      addNoiseSignals(engine);
 
    theHitResponse->finalizeHits(engine);
    // std::cout << " In CaloTDigitizer, after finalize hits " << std::endl;
 
    theElectronicsSim->newEvent(engine);
 
    // reserve space for how many digis we expect
    int nDigisExpected = addNoise_ ? theDetIds->size() : theHitResponse->nSignals();
    output.reserve(nDigisExpected);
    if (debugCS_) {
      csColl_.clear();
      csColl_.reserve(nDigisExpected);
      theHitResponse->setStorePrecise(true);
    }
 
    // make a raw digi for evey cell
    for (std::vector<DetId>::const_iterator idItr = theDetIds->begin(); idItr != theDetIds->end(); ++idItr) {
      CaloSamples *analogSignal = theHitResponse->findSignal(*idItr);
      if (analogSignal && debugCS_)
        csColl_.push_back(*analogSignal);
      bool needToDeleteSignal = false;
      // don't bother digitizing if no signal and no noise
      if (analogSignal == nullptr && addNoise_) {
        // I guess we need to make a blank signal for this cell.
        // Don't bother storing it anywhere.
        analogSignal = new CaloSamples(theHitResponse->makeBlankSignal(*idItr));
        needToDeleteSignal = true;
      }
      if (analogSignal != nullptr) {
        runAnalogToDigital(output, engine, analogSignal, idItr, theElectronicsSim);
        if (needToDeleteSignal)
          delete analogSignal;
      }
    }
 
    // free up some memory
    theHitResponse->clear();
  }

References CaloTDigitizer< Traits, runHelper >::addNoise_, CaloTDigitizer< Traits, runHelper >::addNoiseSignals(), cms::cuda::assert(), CaloHitResponse::clear(), CaloTDigitizer< Traits, runHelper >::csColl_, CaloTDigitizer< Traits, runHelper >::debugCS_, CaloHitResponse::finalizeHits(), CaloHitResponse::findSignal(), CaloHitResponse::makeBlankSignal(), CaloHitResponse::nSignals(), convertSQLitetoXML_cfg::output, CaloTDigitizer< Traits, runHelper >::runAnalogToDigital, CaloHitResponse::setStorePrecise(), CaloTDigitizer< Traits, runHelper >::theDetIds, CaloTDigitizer< Traits, runHelper >::theElectronicsSim, CaloTDigitizer< Traits, runHelper >::theHitResponse, and CaloTDigitizer< Traits, runHelper >::theNoiseSignalGenerator.

run() [2/2]

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

void CaloTDigitizer< Traits, runHelper >::run ( MixCollection< PCaloHit > &  , DigiCollection &    )

inline

turns hits into digis

Definition at line 86 of file CaloTDigitizer.h.

{ assert(0); }

References cms::cuda::assert().

Referenced by CastorDigiProducer::finalizeEvent(), and HcalTBDigiProducer::finalizeEvent().

setDebugCaloSamples()

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

void CaloTDigitizer< Traits, runHelper >::setDebugCaloSamples ( bool  debug )

inline

Definition at line 71 of file CaloTDigitizer.h.

{ debugCS_ = debug; }

References debug, and CaloTDigitizer< Traits, runHelper >::debugCS_.

setDetIds()

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

void CaloTDigitizer< Traits, runHelper >::setDetIds ( const std::vector< DetId > &  detIds )

inline

Definition at line 67 of file CaloTDigitizer.h.

{ theDetIds = &detIds; }

References CaloTDigitizer< Traits, runHelper >::detIds(), and CaloTDigitizer< Traits, runHelper >::theDetIds.

Referenced by CastorDigiProducer::checkGeometry(), and HcalTBDigiProducer::updateGeometry().

setNoiseSignalGenerator()

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

void CaloTDigitizer< Traits, runHelper >::setNoiseSignalGenerator ( CaloVNoiseSignalGenerator *  generator )

inline

Definition at line 69 of file CaloTDigitizer.h.

{ theNoiseSignalGenerator = generator; }

References genfragment_ptgun_cfg::generator, and CaloTDigitizer< Traits, runHelper >::theNoiseSignalGenerator.

Member Data Documentation

addNoise_

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

bool CaloTDigitizer< Traits, runHelper >::addNoise_

private

Definition at line 152 of file CaloTDigitizer.h.

Referenced by CaloTDigitizer< Traits, runHelper >::run().

csColl_

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

CaloSamplesCollection CaloTDigitizer< Traits, runHelper >::csColl_

private

Definition at line 154 of file CaloTDigitizer.h.

Referenced by CaloTDigitizer< Traits, runHelper >::getCaloSamples(), and CaloTDigitizer< Traits, runHelper >::run().

debugCS_

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

bool CaloTDigitizer< Traits, runHelper >::debugCS_

private

Definition at line 153 of file CaloTDigitizer.h.

Referenced by CaloTDigitizer< Traits, runHelper >::run(), and CaloTDigitizer< Traits, runHelper >::setDebugCaloSamples().

runAnalogToDigital

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

runHelper<Traits> CaloTDigitizer< Traits, runHelper >::runAnalogToDigital

private

Definition at line 147 of file CaloTDigitizer.h.

Referenced by CaloTDigitizer< Traits, runHelper >::run().

theDetIds

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

const std::vector<DetId>* CaloTDigitizer< Traits, runHelper >::theDetIds

private

Definition at line 151 of file CaloTDigitizer.h.

Referenced by CaloTDigitizer< Traits, runHelper >::detIds(), CaloTDigitizer< Traits, runHelper >::run(), and CaloTDigitizer< Traits, runHelper >::setDetIds().

theElectronicsSim

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

ElectronicsSim* CaloTDigitizer< Traits, runHelper >::theElectronicsSim

private

Definition at line 150 of file CaloTDigitizer.h.

Referenced by CaloTDigitizer< Traits, runHelper >::run().

theHitResponse

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

CaloHitResponse* CaloTDigitizer< Traits, runHelper >::theHitResponse

private

Definition at line 148 of file CaloTDigitizer.h.

Referenced by CaloTDigitizer< Traits, runHelper >::add(), CaloTDigitizer< Traits, runHelper >::addNoiseSignals(), CaloTDigitizer< Traits, runHelper >::initializeHits(), and CaloTDigitizer< Traits, runHelper >::run().

theNoiseSignalGenerator

template<class Traits , template< class > class runHelper = CaloTDigitizerDefaultRun>

CaloVNoiseSignalGenerator* CaloTDigitizer< Traits, runHelper >::theNoiseSignalGenerator

private

Definition at line 149 of file CaloTDigitizer.h.

Referenced by CaloTDigitizer< Traits, runHelper >::addNoiseSignals(), CaloTDigitizer< Traits, runHelper >::run(), and CaloTDigitizer< Traits, runHelper >::setNoiseSignalGenerator().