CMS 3D CMS Logo

List of all members | Public Member Functions | Static Public Attributes | Private Member Functions | Private Attributes
CSCGasCollisions Class Reference

#include <CSCGasCollisions.h>

Public Member Functions

 CSCGasCollisions (const edm::ParameterSet &pset)
 
bool dumpGasCollisions (void) const
 
bool saveGasCollisions (void) const
 
void setParticleDataTable (const ParticleDataTable *pdt)
 
void simulate (const PSimHit &, std::vector< LocalPoint > &clusters, std::vector< int > &electrons, CLHEP::HepRandomEngine *)
 
virtual ~CSCGasCollisions ()
 

Static Public Attributes

static const int MAX_STEPS = 400
 
static const int N_ENERGY = 63
 
static const int N_ENTRIES = N_GAMMA * N_ENERGY
 
static const int N_GAMMA = 21
 

Private Member Functions

void fillCollisionsForThisGamma (float, std::vector< float > &) const
 
float generateEnergyLoss (double avCollisions, double anmin, double anmax, const std::vector< float > &collisions, CLHEP::HepRandomEngine *) const
 
double generateStep (double avCollisions, CLHEP::HepRandomEngine *) const
 
void ionize (double energyTransferred, LocalPoint startHere) const
 
float lnEnergyLoss (float, const std::vector< float > &) const
 
void readCollisionTable ()
 
void writeSummary (int n_try, int n_steps, double sum_steps, float dedx, const PSimHit &simhit) const
 

Private Attributes

double clusterExtent
 
double deCut
 
bool dumpGasCollisions_
 
double eion
 
double ework
 
double gasDensity
 
const std::string me
 
bool saveGasCollisions_
 
std::vector< float > theCollisionTable
 
CSCCrossGaptheCrossGap
 
std::vector< float > theEnergyBins
 
std::vector< float > theGammaBins
 
const ParticleDataTabletheParticleDataTable
 

Detailed Description

Class to handle CSC gas ionization simulation during digitization.

Author
Tim Cox

This class contains the port of the old CMSIM/ORCA Fortran routine mc_clus.F, and the GEANT3 code it relied on. Of course the version here is much improved :)

Definition at line 27 of file CSCGasCollisions.h.

Constructor & Destructor Documentation

◆ CSCGasCollisions()

CSCGasCollisions::CSCGasCollisions ( const edm::ParameterSet pset)

Definition at line 58 of file CSCGasCollisions.cc.

59  : me("CSCGasCollisions"),
60  gasDensity(2.1416e-03),
61  deCut(1.e05),
62  eion(14.95),
63  ework(34.0),
64  clusterExtent(0.001),
65  theGammaBins(N_GAMMA, 0.),
68  theCrossGap(nullptr),
69  theParticleDataTable(nullptr),
70  saveGasCollisions_(false),
71  dumpGasCollisions_(false) {
72  dumpGasCollisions_ = pset.getUntrackedParameter<bool>("dumpGasCollisions");
73 
74  edm::LogInfo(me) << "Constructing a " << me << ":";
75  edm::LogInfo(me) << "gas density = " << gasDensity << " g/cm3";
76  edm::LogInfo(me) << "max eloss per collision allowed = " << deCut / 1000.
77  << " keV (for higher elosses, hits should have been simulated.)";
78  edm::LogInfo(me) << "ionization threshold = " << eion << " eV";
79  edm::LogInfo(me) << "effective work function = " << ework << " eV";
80  edm::LogInfo(me) << "cluster extent = " << clusterExtent * 1.e04 << " micrometres";
81  edm::LogInfo(me) << "dump gas collision and simhit information? " << dumpGasCollisions();
82  edm::LogInfo(me) << "save gas collision information? -NOT YET IMPLEMENTED- " << saveGasCollisions();
83 
85 }

References clusterExtent, deCut, dumpGasCollisions(), dumpGasCollisions_, eion, ework, gasDensity, me, muonDTDigis_cfi::pset, readCollisionTable(), and saveGasCollisions().

◆ ~CSCGasCollisions()

CSCGasCollisions::~CSCGasCollisions ( )
virtual

Definition at line 87 of file CSCGasCollisions.cc.

87  {
88  edm::LogInfo(me) << "Destructing a " << me;
89  delete theCrossGap;
90 }

References me, and theCrossGap.

Member Function Documentation

◆ dumpGasCollisions()

bool CSCGasCollisions::dumpGasCollisions ( void  ) const
inline

Definition at line 39 of file CSCGasCollisions.h.

39 { return dumpGasCollisions_; }

References dumpGasCollisions_.

Referenced by CSCGasCollisions(), generateEnergyLoss(), generateStep(), and simulate().

◆ fillCollisionsForThisGamma()

void CSCGasCollisions::fillCollisionsForThisGamma ( float  logGamma,
std::vector< float > &  collisions 
) const
private

Definition at line 551 of file CSCGasCollisions.cc.

551  {
552  std::vector<float>::const_iterator bigger =
553  find_if(theGammaBins.begin(), theGammaBins.end(), [&logGamma](auto c) { return c > logGamma; });
554 
555  if (bigger == theGammaBins.end()) {
556  // use highest bin
557  LogTrace(me) << ": using highest gamma bin"
558  << " for logGamma = " << logGamma;
559  for (int i = 0; i < N_ENERGY; ++i)
560  collisions[i] = theCollisionTable[i * N_GAMMA];
561  } else {
562  // use bigger and its lower neighbour
563  std::vector<float>::difference_type ihi = bigger - theGammaBins.begin();
564  if (ihi > 0) {
565  double dlg2 = *bigger--; // and decrement after deref
566  // LogTrace(me) << ": using gamma bins "
567  // << ihi-1 << " and " << ihi;
568  double dlg1 = *bigger; // now the preceding element
569  double dlg = (logGamma - dlg1) / (dlg2 - dlg1);
570  double omdlg = 1. - dlg;
571  for (int i = 0; i < N_ENERGY; ++i)
572  collisions[i] = theCollisionTable[i * N_GAMMA + ihi - 1] * omdlg + theCollisionTable[i * N_GAMMA + ihi] * dlg;
573  } else {
574  // bigger has no lower neighbour
575  LogTrace(me) << ": using lowest gamma bin"
576  << " for logGamma = " << logGamma;
577 
578  for (int i = 0; i < N_ENERGY; ++i)
579  collisions[i] = theCollisionTable[i * N_GAMMA];
580  }
581  }
582 }

References HltBtagPostValidation_cff::c, mps_fire::i, LogTrace, me, N_ENERGY, N_GAMMA, theCollisionTable, and theGammaBins.

Referenced by simulate().

◆ generateEnergyLoss()

float CSCGasCollisions::generateEnergyLoss ( double  avCollisions,
double  anmin,
double  anmax,
const std::vector< float > &  collisions,
CLHEP::HepRandomEngine *  engine 
) const
private

Definition at line 294 of file CSCGasCollisions.cc.

298  {
299  // Generate a no. of collisions between collisions[0] and [N_ENERGY-1]
300  float lnColl = log(CLHEP::RandFlat::shoot(engine, anmin, anmax));
301 
302  // Without using CLHEP: approx random between anmin and anmax
303  // double ra = double(rand())/double(RAND_MAX)*avCollisions;
304  // cout << "ra = " << ra << std::endl;
305  // float lnColl = static_cast<float>( log( ra ) );
306 
307  // Find energy loss for that number
308  float lnE = lnEnergyLoss(lnColl, collisions);
309  float eloss = exp(lnE);
310  // Compensate if gamma was actually below 1.1
311  if (theCrossGap->gamma() < 1.1)
312  eloss = eloss * 0.173554 / theCrossGap->beta2();
313  LogTrace(me) << "eloss = " << eloss << " eV";
314  // Next line only used to fill container of eloss's for later diagnostic dumps
315  if (dumpGasCollisions())
316  theCrossGap->addEloss(eloss);
317  return eloss;
318 }

References CSCCrossGap::addEloss(), CSCCrossGap::beta2(), dumpGasCollisions(), JetChargeProducer_cfi::exp, CSCCrossGap::gamma(), lnEnergyLoss(), dqm-mbProfile::log, LogTrace, me, and theCrossGap.

Referenced by simulate().

◆ generateStep()

double CSCGasCollisions::generateStep ( double  avCollisions,
CLHEP::HepRandomEngine *  engine 
) const
private

Definition at line 278 of file CSCGasCollisions.cc.

278  {
279  // Generate a m.f.p. (1/avCollisions = cm/collision)
280  double step = (CLHEP::RandExponential::shoot(engine)) / avCollisions;
281 
282  // Without using CLHEP: approx random exponential by...
283  // double da = double(rand())/double(RAND_MAX);
284  // double step = -log(1.-da)/avCollisions;
285 
286  LogTrace(me) << " step = " << step << " cm";
287  // Next line only used to fill a container of 'step's for later diagnostic
288  // dumps
289  if (dumpGasCollisions())
291  return step;
292 }

References CSCCrossGap::addStep(), dumpGasCollisions(), LogTrace, me, and theCrossGap.

Referenced by simulate().

◆ ionize()

void CSCGasCollisions::ionize ( double  energyTransferred,
LocalPoint  startHere 
) const
private

Definition at line 320 of file CSCGasCollisions.cc.

320  {
321  while (energyAvailable > eion) {
322  LogTrace(me) << " NEW CLUSTER " << theCrossGap->noOfClusters() + 1 << " AT " << startHere;
323  LocalPoint newCluster(startHere);
324  theCrossGap->addCluster(newCluster);
325 
326  //@@ I consider NOT subtracting eion before calculating range to be a bug.
327  //@@ But this changes tuning of the algorithm so leave it until after the
328  // big rush to 7_5_0
329  //@@ energyAvailable -= eion;
330 
331  // Sauli CERN 77-09: delta e range with E in MeV (Sauli references Kobetich
332  // & Katz 1968 but that has nothing to do with this expression! He seems to
333  // have made a mistake.) I found the Sauli-quoted relationship in R.
334  // Glocker, Z. Naturforsch. Ba, 129 (1948): delta e range R = aE^n with
335  // a=710, n=1.72 for E in MeV and R in mg/cm^2 applicable over the range E =
336  // 0.001 to 0.3 MeV.
337 
338  // Take HALF that range. //@@ Why? Why not...
339  double range = 0.5 * (0.71 / gasDensity) * pow(energyAvailable * 1.E-6, 1.72);
340  LogTrace(me) << " range = " << range << " cm";
341  if (range < clusterExtent) {
342  // short-range delta e
343  // How many electrons can we make? Now use *average* energy for ionization
344  // (not *minimum*)
345  int nelec = static_cast<int>(energyAvailable / ework);
346  LogTrace(me) << "short-range delta energy in = " << energyAvailable << " eV";
347  // energyAvailable -= nelec*(energyAvailable/ework);
348  energyAvailable -= nelec * ework;
349  // If still above eion (minimum, not average) add one more e
350  if (energyAvailable > eion) {
351  ++nelec;
352  energyAvailable -= eion;
353  }
354  LogTrace(me) << "short-range delta energy out = " << energyAvailable << " eV, nelec = " << nelec;
355  theCrossGap->addElectrons(nelec);
356  break;
357 
358  } else {
359  // long-range delta e
360  LogTrace(me) << "long-range delta \n"
361  << "no. of electrons in cluster now = " << theCrossGap->noOfElectrons();
362  theCrossGap->addElectrons(1); // Position is at startHere still
363 
364  bool new_range = false;
365  while (!new_range && (energyAvailable > ework)) {
366  energyAvailable -= ework;
367  while (energyAvailable > eion) {
368  double range2 = 0.5 * 0.71 / gasDensity * pow(1.E-6 * energyAvailable, 1.72);
369  double drange = range - range2;
370  LogTrace(me) << " energy left = " << energyAvailable << " eV, range2 = " << range2
371  << " cm, drange = " << drange << " cm";
372  if (drange < clusterExtent) {
373  theCrossGap->addElectronToBack(); // increment last element
374  } else {
375  startHere += drange * theCrossGap->unitVector(); // update delta e start position
376  range = range2; // update range
377  new_range = true; // Test range again
378  LogTrace(me) << "reset range to range2 = " << range << " from startHere = " << startHere << " and iterate";
379  }
380  break; // out of inner while energyAvailable>eion
381 
382  } // inner while energyAvailable>eion
383 
384  } // while !new_range && energyAvailable>ework
385 
386  // energyAvailable now less than ework, but still may be over eion...add
387  // an e
388  if (energyAvailable > eion) {
389  energyAvailable -= ework; // yes, it may go negative
390  theCrossGap->addElectronToBack(); // add one more e
391  }
392 
393  } // if range
394 
395  } // outer while energyAvailable>eion
396 }

References CSCCrossGap::addCluster(), CSCCrossGap::addElectrons(), CSCCrossGap::addElectronToBack(), clusterExtent, eion, ework, gasDensity, LogTrace, me, CSCCrossGap::noOfClusters(), CSCCrossGap::noOfElectrons(), funct::pow(), FastTimerService_cff::range, theCrossGap, and CSCCrossGap::unitVector().

Referenced by simulate().

◆ lnEnergyLoss()

float CSCGasCollisions::lnEnergyLoss ( float  lnCollisions,
const std::vector< float > &  collisions 
) const
private

Definition at line 520 of file CSCGasCollisions.cc.

520  {
521  float lnE = -1.;
522 
523  // Find collision[] bin in which lnCollisions falls
524  std::vector<float>::const_iterator it = find(collisions.begin(), collisions.end(), lnCollisions);
525 
526  if (it != collisions.end()) {
527  // found the value
528  std::vector<float>::difference_type ihi = it - collisions.begin();
529  LogTrace(me) << ": using one energy bin " << ihi << " = " << theEnergyBins[ihi]
530  << " for lnCollisions = " << lnCollisions;
531  lnE = theEnergyBins[ihi];
532  } else {
533  // interpolate the value
534  std::vector<float>::const_iterator loside =
535  find_if(collisions.begin(), collisions.end(), [&lnCollisions](auto c) { return c < lnCollisions; });
536  std::vector<float>::difference_type ilo = loside - collisions.begin();
537  if (ilo > 0) {
538  LogTrace(me) << ": using energy bin " << ilo - 1 << " and " << ilo;
539  lnE = theEnergyBins[ilo - 1] + (lnCollisions - collisions[ilo - 1]) *
540  (theEnergyBins[ilo] - theEnergyBins[ilo - 1]) /
541  (collisions[ilo] - collisions[ilo - 1]);
542  } else {
543  LogTrace(me) << ": using one energy bin 0 = " << theEnergyBins[0] << " for lnCollisions = " << lnCollisions;
544  lnE = theEnergyBins[0]; //@@ WHAT ELSE TO DO?
545  }
546  }
547 
548  return lnE;
549 }

References HltBtagPostValidation_cff::c, spr::find(), LogTrace, me, and theEnergyBins.

Referenced by generateEnergyLoss().

◆ readCollisionTable()

void CSCGasCollisions::readCollisionTable ( )
private

Definition at line 92 of file CSCGasCollisions.cc.

92  {
93  // I'd prefer to allow comments in the data file which means
94  // complications of reading line-by-line and then item-by-item.
95 
96  // Is float OK? Or do I need double?
97 
98  // Do I need any sort of error trapping?
99 
100  // We use the default CMSSW data file path
101  // We use the default file name 'collisions.dat'
102 
103  // This can be reset in .orcarc by SimpleConfigurable
104  // Muon:Endcap:CollisionsFile
105 
106  // TODO make configurable
107  string colliFile = "SimMuon/CSCDigitizer/data/collisions.dat";
108  edm::FileInPath f1{colliFile};
109  edm::LogInfo(me) << ": reading " << f1.fullPath();
110 
111  ifstream fin{f1.fullPath()};
112 
113  if (fin.fail()) {
114  string errorMessage = "Cannot open input file " + f1.fullPath();
115  edm::LogError("CSCGasCollisions") << errorMessage;
116  throw cms::Exception(errorMessage);
117  }
118 
119  fin.clear(); // Clear eof read status
120  fin.seekg(0, ios::beg); // Position at start of file
121 
122  // @@ We had better have the right sizes everywhere or all
123  // hell will break loose. There's no trapping.
124  LogTrace(me) << "Reading gamma bins";
125  int j = 0;
126  for (int i = 0; i < N_GAMMA; ++i) {
127  fin >> theGammaBins[i];
128  LogTrace(me) << ++j << " " << theGammaBins[i];
129  }
130 
131  j = 0;
132  LogTrace(me) << "Reading energy bins \n";
133  for (int i = 0; i < N_ENERGY; ++i) {
134  fin >> theEnergyBins[i];
135  LogTrace(me) << ++j << " " << theEnergyBins[i];
136  }
137 
138  j = 0;
139  LogTrace(me) << "Reading collisions table \n";
140 
141  for (int i = 0; i < N_ENTRIES; ++i) {
142  fin >> theCollisionTable[i];
143  LogTrace(me) << ++j << " " << theCollisionTable[i];
144  }
145 
146  fin.close();
147 }

References Exception, DeadROC_duringRun::f1, groupFilesInBlocks::fin, mps_fire::i, dqmiolumiharvest::j, LogTrace, me, N_ENERGY, N_ENTRIES, N_GAMMA, theCollisionTable, theEnergyBins, and theGammaBins.

Referenced by CSCGasCollisions().

◆ saveGasCollisions()

bool CSCGasCollisions::saveGasCollisions ( void  ) const
inline

Definition at line 40 of file CSCGasCollisions.h.

40 { return saveGasCollisions_; }

References saveGasCollisions_.

Referenced by CSCGasCollisions().

◆ setParticleDataTable()

void CSCGasCollisions::setParticleDataTable ( const ParticleDataTable pdt)

Definition at line 149 of file CSCGasCollisions.cc.

149 { theParticleDataTable = pdt; }

References theParticleDataTable.

Referenced by CSCWireHitSim::setParticleDataTable().

◆ simulate()

void CSCGasCollisions::simulate ( const PSimHit simhit,
std::vector< LocalPoint > &  clusters,
std::vector< int > &  electrons,
CLHEP::HepRandomEngine *  engine 
)

Definition at line 151 of file CSCGasCollisions.cc.

154  {
155  const float epsilonL = 0.01; // Shortness of simhit 'length'
156  // const float max_gap_z = 1.5; // Gas gaps are 0.5
157  // or 1.0 cm
158 
159  // Note that what I call the 'gap' may in fact be the 'length' of a PSimHit
160  // which does not start and end on the gap edges. This confuses the
161  // nomenclature at least.
162 
163  double mom = simhit.pabs(); // in GeV/c - see MuonSensitiveDetector.cc
164  // int iam = simhit.particleType(); // PDG type
165  delete theCrossGap; // before building new one
166  assert(theParticleDataTable != nullptr);
167  ParticleData const *particle = theParticleDataTable->particle(simhit.particleType());
168  double mass = 0.105658; // assume a muon
169  if (particle == nullptr) {
170  edm::LogError("CSCGasCollisions") << "Cannot find particle of type " << simhit.particleType() << " in the PDT";
171  } else {
172  mass = particle->mass();
173  }
174 
175  theCrossGap = new CSCCrossGap(mass, mom, simhit.exitPoint() - simhit.entryPoint());
176  float gapSize = theCrossGap->length();
177 
178  // Test the simhit 'length' (beware of angular effects)
179  // if ( gapSize <= epsilonL || gapSize > max_gap_z ) {
180  if (gapSize <= epsilonL) {
181  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] WARNING! simhit entry and exit are too close - "
182  "skipping simhit:"
183  << "\n entry = " << simhit.entryPoint() << ": exit = " << simhit.exitPoint()
184  << "\n particle type = " << simhit.particleType()
185  << " : momentum = " << simhit.pabs()
186  << " GeV/c : energy loss = " << simhit.energyLoss() * 1.E06 << " keV"
187  << ", gapSize = " << gapSize << " cm (< epsilonL = " << epsilonL << " cm)";
188  return; //@@ Just skip this PSimHit
189  }
190 
191  // Interpolate the table for current gamma value
192  // Extract collisions binned by energy loss values, for this gamma
193  std::vector<float> collisions(N_ENERGY);
194  double loggam = theCrossGap->logGamma();
195  fillCollisionsForThisGamma(static_cast<float>(loggam), collisions);
196 
197  double anmin = exp(collisions[N_ENERGY - 1]);
198  double anmax = exp(collisions[0]);
199  double amu = anmax - anmin;
200 
201  LogTrace(me) << "collisions extremes = " << collisions[N_ENERGY - 1] << ", " << collisions[0] << "\n"
202  << "anmin = " << anmin << ", anmax = " << anmax << "\n"
203  << "amu = " << amu << "\n";
204 
205  float dedx = 0.; // total energy loss
206  double sum_steps = 0.; // total distance across gap (along simhit direction)
207  int n_steps = 0; // no. of steps/primary collisions
208  int n_try = 0; // no. of tries to generate steps
209  double step = -1.; // Sentinel for start
210 
211  LocalPoint layerLocalPoint(simhit.entryPoint());
212 
213  // step/primary collision loop
214  while (sum_steps < gapSize) {
215  ++n_try;
216  if (n_try > MAX_STEPS) {
217  int maxst = MAX_STEPS;
218  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] WARNING! n_try = " << n_try
219  << " is > MAX_STEPS = " << maxst << " - skipping simhit:"
220  << "\n entry = " << simhit.entryPoint() << ": exit = " << simhit.exitPoint()
221  << "\n particle type = " << simhit.particleType()
222  << " : momentum = " << simhit.pabs()
223  << " GeV/c : energy loss = " << simhit.energyLoss() * 1.E06 << " keV"
224  << "\n gapSize = " << gapSize << " cm, last step = " << step
225  << " cm, sum_steps = " << sum_steps << " cm, n_steps = " << n_steps;
226  break;
227  }
228  step = generateStep(amu, engine);
229  if (sum_steps + step > gapSize)
230  break; // this step goes too far
231 
232  float eloss = generateEnergyLoss(amu, anmin, anmax, collisions, engine);
233 
234  // Is the eloss too large? (then GEANT should have produced hits!)
235  if (eloss > deCut) {
236  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] WARNING! eloss = " << eloss << " eV is too large (> "
237  << deCut << " eV) - trying another collision";
238  continue; // to generate another collision/step
239  }
240 
241  dedx += eloss; // the energy lost from the ionizing particle
242  sum_steps += step; // the position of the ionizing particle
243  ++n_steps; // the number of primary collisions
244 
245  if (n_steps > MAX_STEPS) { // Extra-careful trap for bizarreness
246  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] WARNING! " << n_steps
247  << " is too many steps - skipping simhit:"
248  << "\n entry = " << simhit.entryPoint() << ": exit = " << simhit.exitPoint()
249  << "\n particle type = " << simhit.particleType()
250  << " : momentum = " << simhit.pabs()
251  << " GeV/c : energy loss = " << simhit.energyLoss() * 1.E06 << " keV"
252  << "\ngapSize=" << gapSize << " cm, last step=" << step
253  << " cm, sum_steps=" << sum_steps << " cm";
254  break;
255  }
256  LogTrace(me) << "sum_steps = " << sum_steps << " cm , dedx = " << dedx << " eV";
257 
258  // Generate ionization.
259  // eion is the minimum energy at which ionization can occur in the gas
260  if (eloss > eion) {
261  layerLocalPoint += step * theCrossGap->unitVector(); // local point where the collision occurs
262  ionize(eloss, layerLocalPoint);
263  } else {
264  LogTrace(me) << "Energy available = " << eloss << " eV is too low for ionization (< eion = " << eion << " eV)";
265  }
266 
267  } // step/collision loop
268 
269  if (dumpGasCollisions())
270  writeSummary(n_try, n_steps, sum_steps, dedx, simhit);
271 
272  // Return values in two container arguments
273  positions = theCrossGap->ionClusters();
275  return;
276 }

References cms::cuda::assert(), deCut, dumpGasCollisions(), eion, pwdgSkimBPark_cfi::electrons, CSCCrossGap::electrons(), PSimHit::energyLoss(), PSimHit::entryPoint(), PSimHit::exitPoint(), JetChargeProducer_cfi::exp, fillCollisionsForThisGamma(), generateEnergyLoss(), generateStep(), CSCCrossGap::ionClusters(), ionize(), CSCCrossGap::length(), CSCCrossGap::logGamma(), LogTrace, EgHLTOffHistBins_cfi::mass, MAX_STEPS, me, N_ENERGY, PSimHit::pabs(), PSimHit::particleType(), theCrossGap, theParticleDataTable, CSCCrossGap::unitVector(), and writeSummary().

Referenced by CSCWireHitSim::getIonizationClusters().

◆ writeSummary()

void CSCGasCollisions::writeSummary ( int  n_try,
int  n_steps,
double  sum_steps,
float  dedx,
const PSimHit simhit 
) const
private

Definition at line 398 of file CSCGasCollisions.cc.

398  {
399  // Switched from std::cout to LogVerbatim, Mar 2015
400 
401  std::vector<LocalPoint> ion_clusters = theCrossGap->ionClusters();
402  std::vector<int> electrons = theCrossGap->electrons();
403  std::vector<float> elosses = theCrossGap->eLossPerStep();
404  std::vector<double> steps = theCrossGap->stepLengths();
405 
406  edm::LogVerbatim("CSCDigitizer") << "------------------"
407  << "\nAFTER CROSSING GAP";
408  /*
409  edm::LogVerbatim("CSCDigitizer") << "no. of steps tried = " <<
410  n_try
411  << "\nno. of steps from theCrossGap = " <<
412  theCrossGap->noOfSteps()
413  << "\nsize of steps vector = " <<
414  steps.size();
415 
416  edm::LogVerbatim("CSCDigitizer") << "no. of collisions (steps) = " <<
417  n_steps
418  << "\nsize of elosses vector = " <<
419  elosses.size()
420  << "\nsize of ion clusters vector = " <<
421  ion_clusters.size()
422  << "\nsize of electrons vector = " <<
423  electrons.size();
424  */
425 
426  size_t nsteps = n_steps; // force ridiculous type conversion
427  size_t mstep = steps.size() - 1; // final step gets filled but is outside gas
428  // gap - unless we reach MAX_STEPS
429  if ((nsteps != MAX_STEPS) && (nsteps != mstep)) {
430  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] WARNING! no. of steps = " << nsteps
431  << " .ne. steps.size()-1 = " << mstep;
432  }
433  size_t meloss = elosses.size();
434 
435  if (nsteps != meloss) {
436  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] WARNING! no. of steps = " << nsteps
437  << " .ne. no. of elosses = " << meloss;
438  } else {
439  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] # / length of step / energy loss per collision:";
440  for (size_t i = 0; i != nsteps; ++i) {
441  edm::LogVerbatim("CSCDigitizer") << i + 1 << " / S: " << steps[i] << " / E: " << elosses[i];
442  }
443  }
444 
445  size_t mclus = ion_clusters.size();
446  size_t melec = electrons.size();
447 
448  if (mclus != melec) {
449  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] WARNING! size of cluster vector = " << mclus
450  << " .ne. size of electrons vector = " << melec;
451  } else {
452  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] # / postion of "
453  "cluster / electrons per cluster: ";
454  for (size_t i = 0; i != mclus; ++i) {
455  edm::LogVerbatim("CSCDigitizer") << i + 1 << " / I: " << ion_clusters[i] << " / E: " << electrons[i];
456  }
457  }
458 
459  int n_ic = count_if(elosses.begin(), elosses.end(), [&](auto c) { return c > this->eion; });
460 
461  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] total no. of collision steps = " << n_steps;
462  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] total sum of steps = " << sum_steps << " cm";
463  if (nsteps > 0)
464  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] average step length = " << sum_steps / float(nsteps)
465  << " cm";
466  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] total energy loss across gap = " << dedx
467  << " eV = " << dedx / 1000. << " keV";
468  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] no. of primary ionizing collisions across gap = "
469  "no. with eloss > eion = "
470  << eion << " eV = " << n_ic;
471  if (nsteps > 0)
472  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] average energy loss/collision = " << dedx / float(nsteps)
473  << " eV";
474 
475  std::vector<int>::const_iterator bigger = find(electrons.begin(), electrons.end(), 0);
476  if (bigger != electrons.end()) {
477  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] TROUBLE! There is a cluster with 0 electrons.";
478  }
479 
480  int n_e = accumulate(electrons.begin(), electrons.end(), 0);
481 
482  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] SUMMARY: simhit"
483  << "\n entry = " << simhit.entryPoint() << ": exit = " << simhit.exitPoint()
484  << "\n particle type = " << simhit.particleType()
485  << " : momentum = " << simhit.pabs()
486  << " GeV/c : energy loss = " << simhit.energyLoss() * 1.E06 << " keV";
487 
488  if (nsteps > 0) {
489  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisions] SUMMARY: ionization"
490  << " : steps= " << nsteps << " : sum(steps)= " << sum_steps
491  << " cm : <step>= " << sum_steps / float(nsteps) << " cm"
492  << " : ionizing= " << n_ic << " : ionclus= " << mclus << " : total e= " << n_e
493  << " : <dedx/step>= " << dedx / float(nsteps)
494  << " eV : <e/ionclus>= " << float(n_e) / float(mclus)
495  << " : dedx= " << dedx / 1000. << " keV";
496  } else {
497  edm::LogVerbatim("CSCDigitizer") << "[CSCGasCollisons] ERROR? no collision steps!";
498  }
499 
500  // Turn off output file - used for initial development
501  // if ( saveGasCollisions() ) {
502  // ofstream of0("osteplen.dat",ios::app);
503  // std::copy( steps.begin(), steps.end(),
504  // std::ostream_iterator<float>(of0,"\n"));
505 
506  // ofstream of1("olperc.dat",ios::app);
507  // std::copy( elosses.begin(), elosses.end(),
508  // std::ostream_iterator<float>(of1,"\n"));
509 
510  // ofstream of2("oclpos.dat",ios::app);
511  // std::copy( ion_clusters.begin(), ion_clusters.end(),
512  // std::ostream_iterator<LocalPoint>(of2,"\n"));
513 
514  // ofstream of3("oepercl.dat",ios::app);
515  // std::copy( electrons.begin(), electrons.end(),
516  // std::ostream_iterator<int>(of3,"\n"));
517  // }
518 }

References HltBtagPostValidation_cff::c, eion, pwdgSkimBPark_cfi::electrons, CSCCrossGap::electrons(), CSCCrossGap::eLossPerStep(), PSimHit::energyLoss(), PSimHit::entryPoint(), PSimHit::exitPoint(), spr::find(), dqmMemoryStats::float, mps_fire::i, CSCCrossGap::ionClusters(), MAX_STEPS, PSimHit::pabs(), PSimHit::particleType(), CSCCrossGap::stepLengths(), customisers::steps, and theCrossGap.

Referenced by simulate().

Member Data Documentation

◆ clusterExtent

double CSCGasCollisions::clusterExtent
private

Definition at line 72 of file CSCGasCollisions.h.

Referenced by CSCGasCollisions(), and ionize().

◆ deCut

double CSCGasCollisions::deCut
private

Definition at line 69 of file CSCGasCollisions.h.

Referenced by CSCGasCollisions(), and simulate().

◆ dumpGasCollisions_

bool CSCGasCollisions::dumpGasCollisions_
private

Definition at line 83 of file CSCGasCollisions.h.

Referenced by CSCGasCollisions(), and dumpGasCollisions().

◆ eion

double CSCGasCollisions::eion
private

Definition at line 70 of file CSCGasCollisions.h.

Referenced by CSCGasCollisions(), ionize(), simulate(), and writeSummary().

◆ ework

double CSCGasCollisions::ework
private

Definition at line 71 of file CSCGasCollisions.h.

Referenced by CSCGasCollisions(), and ionize().

◆ gasDensity

double CSCGasCollisions::gasDensity
private

Definition at line 63 of file CSCGasCollisions.h.

Referenced by CSCGasCollisions(), and ionize().

◆ MAX_STEPS

const int CSCGasCollisions::MAX_STEPS = 400
static

Definition at line 45 of file CSCGasCollisions.h.

Referenced by simulate(), and writeSummary().

◆ me

const std::string CSCGasCollisions::me
private

◆ N_ENERGY

const int CSCGasCollisions::N_ENERGY = 63
static

Definition at line 43 of file CSCGasCollisions.h.

Referenced by fillCollisionsForThisGamma(), readCollisionTable(), and simulate().

◆ N_ENTRIES

const int CSCGasCollisions::N_ENTRIES = N_GAMMA * N_ENERGY
static

Definition at line 44 of file CSCGasCollisions.h.

Referenced by readCollisionTable().

◆ N_GAMMA

const int CSCGasCollisions::N_GAMMA = 21
static

Definition at line 42 of file CSCGasCollisions.h.

Referenced by fillCollisionsForThisGamma(), and readCollisionTable().

◆ saveGasCollisions_

bool CSCGasCollisions::saveGasCollisions_
private

Definition at line 81 of file CSCGasCollisions.h.

Referenced by saveGasCollisions().

◆ theCollisionTable

std::vector<float> CSCGasCollisions::theCollisionTable
private

Definition at line 77 of file CSCGasCollisions.h.

Referenced by fillCollisionsForThisGamma(), and readCollisionTable().

◆ theCrossGap

CSCCrossGap* CSCGasCollisions::theCrossGap
private

◆ theEnergyBins

std::vector<float> CSCGasCollisions::theEnergyBins
private

Definition at line 76 of file CSCGasCollisions.h.

Referenced by lnEnergyLoss(), and readCollisionTable().

◆ theGammaBins

std::vector<float> CSCGasCollisions::theGammaBins
private

Definition at line 75 of file CSCGasCollisions.h.

Referenced by fillCollisionsForThisGamma(), and readCollisionTable().

◆ theParticleDataTable

const ParticleDataTable* CSCGasCollisions::theParticleDataTable
private

Definition at line 80 of file CSCGasCollisions.h.

Referenced by setParticleDataTable(), and simulate().

FastTimerService_cff.range
range
Definition: FastTimerService_cff.py:34
CSCCrossGap::unitVector
LocalVector unitVector() const
Definition: CSCCrossGap.h:53
CSCGasCollisions::theEnergyBins
std::vector< float > theEnergyBins
Definition: CSCGasCollisions.h:76
mps_fire.i
i
Definition: mps_fire.py:355
dqmMemoryStats.float
float
Definition: dqmMemoryStats.py:127
CSCCrossGap::noOfClusters
int noOfClusters() const
Definition: CSCCrossGap.h:33
CSCCrossGap::stepLengths
std::vector< double > stepLengths() const
Definition: CSCCrossGap.h:36
CSCGasCollisions::ionize
void ionize(double energyTransferred, LocalPoint startHere) const
Definition: CSCGasCollisions.cc:320
step
step
Definition: StallMonitor.cc:94
CSCCrossGap::addEloss
void addEloss(float eloss)
Definition: CSCCrossGap.h:46
CSCGasCollisions::MAX_STEPS
static const int MAX_STEPS
Definition: CSCGasCollisions.h:45
CSCCrossGap::addElectrons
void addElectrons(int nelec=1)
Definition: CSCCrossGap.h:42
CSCCrossGap::addElectronToBack
void addElectronToBack()
Definition: CSCCrossGap.h:43
CSCGasCollisions::N_ENTRIES
static const int N_ENTRIES
Definition: CSCGasCollisions.h:44
edm::LogInfo
Definition: MessageLogger.h:254
cms::cuda::assert
assert(be >=bs)
CSCCrossGap
Definition: CSCCrossGap.h:22
CSCGasCollisions::generateStep
double generateStep(double avCollisions, CLHEP::HepRandomEngine *) const
Definition: CSCGasCollisions.cc:278
spr::find
void find(edm::Handle< EcalRecHitCollection > &hits, DetId thisDet, std::vector< EcalRecHitCollection::const_iterator > &hit, bool debug=false)
Definition: FindCaloHit.cc:19
PSimHit::entryPoint
Local3DPoint entryPoint() const
Entry point in the local Det frame.
Definition: PSimHit.h:43
CSCGasCollisions::readCollisionTable
void readCollisionTable()
Definition: CSCGasCollisions.cc:92
ParticleData
HepPDT::ParticleData ParticleData
Definition: ParticleDataTable.h:9
CSCGasCollisions::eion
double eion
Definition: CSCGasCollisions.h:70
edm::FileInPath
Definition: FileInPath.h:64
PSimHit::pabs
float pabs() const
fast and more accurate access to momentumAtEntry().mag()
Definition: PSimHit.h:67
CSCGasCollisions::saveGasCollisions
bool saveGasCollisions(void) const
Definition: CSCGasCollisions.h:40
CSCGasCollisions::dumpGasCollisions_
bool dumpGasCollisions_
Definition: CSCGasCollisions.h:83
CSCCrossGap::gamma
double gamma() const
Definition: CSCCrossGap.h:51
CSCCrossGap::eLossPerStep
std::vector< float > eLossPerStep() const
Definition: CSCCrossGap.h:38
PSimHit::exitPoint
Local3DPoint exitPoint() const
Exit point in the local Det frame.
Definition: PSimHit.h:46
groupFilesInBlocks.fin
fin
Definition: groupFilesInBlocks.py:94
Point3DBase< float, LocalTag >
CSCGasCollisions::gasDensity
double gasDensity
Definition: CSCGasCollisions.h:63
CSCCrossGap::beta2
double beta2() const
Definition: CSCCrossGap.h:50
CSCGasCollisions::fillCollisionsForThisGamma
void fillCollisionsForThisGamma(float, std::vector< float > &) const
Definition: CSCGasCollisions.cc:551
CSCGasCollisions::theCrossGap
CSCCrossGap * theCrossGap
Definition: CSCGasCollisions.h:79
CSCGasCollisions::theCollisionTable
std::vector< float > theCollisionTable
Definition: CSCGasCollisions.h:77
CSCGasCollisions::writeSummary
void writeSummary(int n_try, int n_steps, double sum_steps, float dedx, const PSimHit &simhit) const
Definition: CSCGasCollisions.cc:398
CSCGasCollisions::generateEnergyLoss
float generateEnergyLoss(double avCollisions, double anmin, double anmax, const std::vector< float > &collisions, CLHEP::HepRandomEngine *) const
Definition: CSCGasCollisions.cc:294
CSCGasCollisions::ework
double ework
Definition: CSCGasCollisions.h:71
edm::LogError
Definition: MessageLogger.h:183
CSCGasCollisions::clusterExtent
double clusterExtent
Definition: CSCGasCollisions.h:72
CSCGasCollisions::dumpGasCollisions
bool dumpGasCollisions(void) const
Definition: CSCGasCollisions.h:39
CSCCrossGap::logGamma
double logGamma(double mass, float momentum)
Definition: CSCCrossGap.cc:14
CSCCrossGap::ionClusters
std::vector< LocalPoint > ionClusters() const
Definition: CSCCrossGap.h:32
edm::LogVerbatim
Definition: MessageLogger.h:297
CSCGasCollisions::lnEnergyLoss
float lnEnergyLoss(float, const std::vector< float > &) const
Definition: CSCGasCollisions.cc:520
CSCGasCollisions::N_ENERGY
static const int N_ENERGY
Definition: CSCGasCollisions.h:43
HltBtagPostValidation_cff.c
c
Definition: HltBtagPostValidation_cff.py:31
CSCGasCollisions::N_GAMMA
static const int N_GAMMA
Definition: CSCGasCollisions.h:42
CSCGasCollisions::deCut
double deCut
Definition: CSCGasCollisions.h:69
CSCCrossGap::addCluster
void addCluster(LocalPoint here)
Definition: CSCCrossGap.h:41
CSCGasCollisions::saveGasCollisions_
bool saveGasCollisions_
Definition: CSCGasCollisions.h:81
pwdgSkimBPark_cfi.electrons
electrons
Definition: pwdgSkimBPark_cfi.py:6
CSCGasCollisions::theGammaBins
std::vector< float > theGammaBins
Definition: CSCGasCollisions.h:75
CSCGasCollisions::me
const std::string me
Definition: CSCGasCollisions.h:62
Exception
Definition: hltDiff.cc:246
PSimHit::energyLoss
float energyLoss() const
The energy deposit in the PSimHit, in ???.
Definition: PSimHit.h:79
CSCCrossGap::noOfElectrons
int noOfElectrons() const
Definition: CSCCrossGap.h:35
EgHLTOffHistBins_cfi.mass
mass
Definition: EgHLTOffHistBins_cfi.py:34
CSCCrossGap::electrons
std::vector< int > electrons() const
Definition: CSCCrossGap.h:34
CSCCrossGap::length
float length() const
Definition: CSCCrossGap.h:54
PSimHit::particleType
int particleType() const
Definition: PSimHit.h:89
dqm-mbProfile.log
log
Definition: dqm-mbProfile.py:17
customisers.steps
steps
Definition: customisers.py:41
funct::pow
Power< A, B >::type pow(const A &a, const B &b)
Definition: Power.h:30
LogTrace
#define LogTrace(id)
Definition: MessageLogger.h:671
dqmiolumiharvest.j
j
Definition: dqmiolumiharvest.py:66
JetChargeProducer_cfi.exp
exp
Definition: JetChargeProducer_cfi.py:6
DeadROC_duringRun.f1
f1
Definition: DeadROC_duringRun.py:219
CSCGasCollisions::theParticleDataTable
const ParticleDataTable * theParticleDataTable
Definition: CSCGasCollisions.h:80
muonDTDigis_cfi.pset
pset
Definition: muonDTDigis_cfi.py:27
MillePedeFileConverter_cfg.e
e
Definition: MillePedeFileConverter_cfg.py:37
CSCCrossGap::addStep
void addStep(double step)
Definition: CSCCrossGap.h:45