CaloBCIDLumi Class Reference

Luminosity-dependent pileup offset correction conditions object. More...

#include <CaloBCIDLumi.h>

Collaboration diagram for CaloBCIDLumi:

Public Member Functions
	CaloBCIDLumi (const CaloBCIDCoeffs &coeffs, const BunchCrossingCondData &bcData)
	Constructor (for MC).
	CaloBCIDLumi (const CaloBCIDCoeffs &coeffs, const LuminosityCondData &lumiData)
	Constructor (for data).
void	calc (const size_t bcid, const float averageInteractionsPerCrossing, CxxUtils::vec_aligned_vector< float > &out) const
	Perform the calculation for a given BCID.

Private Member Functions
void	initLumi (const std::vector< float > &lumiVec)
	Initialize m_lumiData.

Private Attributes
std::vector< float >	m_lumiData
	Per-BCID luminosities. Padded at the start and end as described above.
const float *	m_lumi = nullptr
	Pointer to the luminosity data for BCID 0 (after initial padding).
const CaloBCIDCoeffs &	m_coeffs
	Associated coefficients conditions object.

Detailed Description

Luminosity-dependent pileup offset correction conditions object.

This implements the cell-by-cell luminosity-dependent offset correction for adjacent bunches. This was previously implemented as an algorithm (CaloBCIDAvgAlg), but it took too long to be usable in the trigger. We can, however, speed it up drastically by preformatting the constant data and saving it in a conditions object. The per-bunch luminosity data are stored here. The processed calibration/shape information is stored in a separate conditions object CaloBCIDCoeffs, as it has a different lifetime.

The per-bunch luminosity vector is considered to be circular. To make this more efficient, we allocate a bit more than is needed, and duplicate the entries at the ends:

bcid[NBCID-nbefore, NBCID)  bcid[0, NBCID)  bcid [0, nafter)

where nbefore is nshapes-1 and nafter is nsamples_coeff-1.

Definition at line 46 of file CaloBCIDLumi.h.

Constructor & Destructor Documentation

CaloBCIDLumi() [1/2]

CaloBCIDLumi::CaloBCIDLumi	(	const CaloBCIDCoeffs &	coeffs,
		const BunchCrossingCondData &	bcData )

Constructor (for MC).

Parameters

coeffs	Corresponding coefficiencts conditions object.
bcData	Flags of occupied bunches.

Definition at line 23 of file CaloBCIDLumi.cxx.

  : m_coeffs (coeffs)
{
  // MC case
  // convert from mu/bunch to lumi in 10**30 units per bunch (for MC only)
  // 25ns*Nbcid*71mb*10**30 = 25e-9*3564*71e-27*1e30 = 6.31 Use 1/6.31 = 0.158478605
  // For this implementation, we multiply through by
  // averageInteractionsByCrossing() in calc().
  const float xlumiMC = /*ei->averageInteractionsPerCrossing()* */ 0.158478605;
 
  static constexpr int MAX_BCID = BunchCrossingCondData::m_MAX_BCID;
 
  std::vector<float> lumiVec (MAX_BCID);
  for (size_t i = 0; i < MAX_BCID; i++) {
    lumiVec[i] = bcData.isFilled(i)*xlumiMC; 
  }
 
  initLumi (lumiVec);
}

CaloBCIDLumi() [2/2]

CaloBCIDLumi::CaloBCIDLumi	(	const CaloBCIDCoeffs &	coeffs,
		const LuminosityCondData &	lumiData )

Constructor (for data).

Parameters

coeffs	Corresponding coefficiencts conditions object.
lumiData	Per-bunch luminosity information.

Definition at line 50 of file CaloBCIDLumi.cxx.

  : m_coeffs (coeffs)
{
  initLumi (lumiData.lbLuminosityPerBCIDVector());
}

Member Function Documentation

calc()

void CaloBCIDLumi::calc	(	const size_t	bcid,
		const float	averageInteractionsPerCrossing,
		CxxUtils::vec_aligned_vector< float > &	out ) const

Perform the calculation for a given BCID.

Parameters

bcid	Desired BCID.
averageInteractionsPerCrossing	Scale to be applied to all outputs.
out	Output per-cell offsets.

Definition at line 94 of file CaloBCIDLumi.cxx.

{
  // Perform the calculation using the proper lumi range for the BCID.
  m_coeffs.calc (m_lumi + bcid, out);
 
  // Scale the results if requested (for MC).
  if (averageInteractionsPerCrossing != 1) {
    for (float& o : out) {
      o *= averageInteractionsPerCrossing;
    }
  }
}

initLumi()

void CaloBCIDLumi::initLumi ( const std::vector< float > & lumiVec )

private

Initialize m_lumiData.

Parameters

lumiVec

Per-BCID luminosities.

Definition at line 62 of file CaloBCIDLumi.cxx.

{
  // Number of entries from the end we put at the beginning.
  unsigned int nbefore = m_coeffs.nshapes()-1;
  // Number of entries from the beginning we put at the end.
  unsigned int nafter = m_coeffs.nsamples_coeff()-1;
 
  m_lumiData.resize (nbefore + lumiVec.size() + nafter);
 
  // Copy [BCID-nbefore, NBCID) to the start of m_lumiData.
  std::copy (lumiVec.end() - nbefore, lumiVec.end(),
             m_lumiData.begin());
 
  // Append [0, NBCID)
  std::copy (lumiVec.begin(), lumiVec.end(),
             m_lumiData.begin() + nbefore);
 
  // Append [0, nafter)
  std::copy (lumiVec.begin(), lumiVec.begin() + nafter,
             m_lumiData.begin() + nbefore + lumiVec.size());
 
  // Set the pointer to BCID 0.
  m_lumi = m_lumiData.data() + nbefore;
}

Member Data Documentation

m_coeffs

const CaloBCIDCoeffs& CaloBCIDLumi::m_coeffs

private

Associated coefficients conditions object.

Definition at line 95 of file CaloBCIDLumi.h.

m_lumi

const float* CaloBCIDLumi::m_lumi = nullptr

private

Pointer to the luminosity data for BCID 0 (after initial padding).

Definition at line 91 of file CaloBCIDLumi.h.

m_lumiData

std::vector<float> CaloBCIDLumi::m_lumiData

private

Per-BCID luminosities. Padded at the start and end as described above.

Definition at line 87 of file CaloBCIDLumi.h.

---

The documentation for this class was generated from the following files:

• CaloBCIDLumi.h
• CaloBCIDLumi.cxx