#include <TotemTimingRecHitProducerAlgorithm.h>

Inheritance diagram for TotemTimingRecHitProducerAlgorithm:

Classes
struct	RegressionResults

Public Member Functions
void	build (const CTPPSGeometry &, const edm::DetSetVector< TotemTimingDigi > &, edm::DetSetVector< TotemTimingRecHit > &) override

void	setCalibration (const PPSTimingCalibration &)

	TotemTimingRecHitProducerAlgorithm (const edm::ParameterSet &)

Public Member Functions inherited from TimingRecHitProducerAlgorithm< CTPPSGeometry, edm::DetSetVector< TotemTimingDigi >, edm::DetSetVector< TotemTimingRecHit > >
void	setCalibration (const PPSTimingCalibration &calib, const PPSTimingCalibrationLUT &calibLUT)

	TimingRecHitProducerAlgorithm (const edm::ParameterSet &iConfig)

virtual	~TimingRecHitProducerAlgorithm ()=default

Private Member Functions
float	constantFractionDiscriminator (const std::vector< float > &time, const std::vector< float > &data)

int	fastDiscriminator (const std::vector< float > &data, float threshold) const

RegressionResults	simplifiedLinearRegression (const std::vector< float > &time, const std::vector< float > &data, const unsigned int start_at, const unsigned int points) const

Private Attributes
int	baselinePoints_

double	cfdFraction_

double	hysteresis_

double	lowPassFrequency_

bool	mergeTimePeaks_

TotemTimingRecHit::TimingAlgorithm	mode_

std::unique_ptr< TotemTimingConversions >	sampicConversions_

double	sampicOffset_

double	sampicSamplingPeriodNs_

double	saturationLimit_

int	smoothingPoints_

Static Private Attributes
static constexpr float	SINC_COEFFICIENT = M_PI * 2 / 7.8

Additional Inherited Members
Protected Attributes inherited from TimingRecHitProducerAlgorithm< CTPPSGeometry, edm::DetSetVector< TotemTimingDigi >, edm::DetSetVector< TotemTimingRecHit > >
bool	apply_calib_
	Switch on/off the timing calibration. More...

const PPSTimingCalibration *	calib_
	DB-loaded calibration object. More...

std::unique_ptr< reco::FormulaEvaluator >	calib_fct_
	Timing correction formula. More...

const PPSTimingCalibrationLUT *	calibLUT_

double	ts_to_ns_
	Conversion constant between time slice and absolute time (in ns) More...

Detailed Description

Definition at line 25 of file TotemTimingRecHitProducerAlgorithm.h.

Constructor & Destructor Documentation

◆ TotemTimingRecHitProducerAlgorithm()

TotemTimingRecHitProducerAlgorithm::TotemTimingRecHitProducerAlgorithm ( const edm::ParameterSet & iConfig )

explicit

Definition at line 20 of file TotemTimingRecHitProducerAlgorithm.cc.

     : TimingRecHitProducerAlgorithm(iConfig),
       mergeTimePeaks_(iConfig.getParameter<bool>("mergeTimePeaks")),
       baselinePoints_(iConfig.getParameter<int>("baselinePoints")),
       saturationLimit_(iConfig.getParameter<double>("saturationLimit")),
       cfdFraction_(iConfig.getParameter<double>("cfdFraction")),
       smoothingPoints_(iConfig.getParameter<int>("smoothingPoints")),
       lowPassFrequency_(iConfig.getParameter<double>("lowPassFrequency")),
       hysteresis_(iConfig.getParameter<double>("hysteresis")),
       sampicOffset_(iConfig.getParameter<double>("sampicOffset")),
       sampicSamplingPeriodNs_(iConfig.getParameter<double>("sampicSamplingPeriodNs")) {}

Member Function Documentation

◆ build()

void TotemTimingRecHitProducerAlgorithm::build	(	const CTPPSGeometry &	geom,
		const edm::DetSetVector< TotemTimingDigi > &	input,
		edm::DetSetVector< TotemTimingRecHit > &	output
	)

overridevirtual

Implements TimingRecHitProducerAlgorithm< CTPPSGeometry, edm::DetSetVector< TotemTimingDigi >, edm::DetSetVector< TotemTimingRecHit > >.

Definition at line 40 of file TotemTimingRecHitProducerAlgorithm.cc.

References baselinePoints_, TotemTimingRecHit::CFD, constantFractionDiscriminator(), data, edm::DetSet< T >::emplace_back(), Exception, relativeConstraints::geom, DetGeomDesc::getDiamondDimensions(), mps_fire::i, input, TotemTimingRecHitProducerAlgorithm::RegressionResults::m, mode_, DetGeomDesc::name(), TotemTimingRecHit::NO_T_AVAILABLE, DetGeomDesc::parentZPosition(), TotemTimingRecHitProducerAlgorithm::RegressionResults::q, TotemTimingRecHitProducerAlgorithm::RegressionResults::rms, sampicConversions_, sampicOffset_, saturationLimit_, simplifiedLinearRegression(), submitPVValidationJobs::t, hcalRecHitTable_cff::time, DetGeomDesc::translation(), and DiamondDimensions::xHalfWidth.

Referenced by TotemTimingRecHitProducer::produce().

                                                                                            {
   for (const auto& vec : input) {
     const CTPPSDetId detid(vec.detId());
 
     float x_pos = 0.f, y_pos = 0.f, z_pos = 0.f;
     float x_width = 0.f, y_width = 0.f, z_width = 0.f;
 
     // retrieve the geometry element associated to this DetID ( if present )
     const DetGeomDesc* det = geom.sensorNoThrow(detid);
 
     if (det) {
       x_pos = det->translation().x();
       y_pos = det->translation().y();
       z_pos = det->parentZPosition();  // retrieve the plane position;
 
       const auto& diamondDimensions = det->getDiamondDimensions();
       x_width = 2.0 * diamondDimensions.xHalfWidth;  // parameters stand for half the size
       y_width = 2.0 * diamondDimensions.yHalfWidth;
       z_width = 2.0 * diamondDimensions.zHalfWidth;
     } else
       throw cms::Exception("TotemTimingRecHitProducerAlgorithm") << "Failed to retrieve a sensor for " << detid;
 
     if (!sampicConversions_)
       throw cms::Exception("TotemTimingRecHitProducerAlgorithm") << "No timing conversion retrieved.";
 
     edm::DetSet<TotemTimingRecHit>& rec_hits = output.find_or_insert(detid);
 
     for (const auto& digi : vec) {
       const float triggerCellTimeInstant(sampicConversions_->triggerTime(digi));
       const float timePrecision(sampicConversions_->timePrecision(digi));
       const std::vector<float> time(sampicConversions_->timeSamples(digi));
       std::vector<float> data(sampicConversions_->voltSamples(digi));
 
       auto [min_it, max_it] = std::minmax_element(data.begin(), data.end());
 
       if (det->name() == "CTPPS_Diamond_Segment") {
         //flip the signal
         for (unsigned int i = 0; i < data.size(); ++i)
           data[i] = -data[i] + sampicOffset_;
       }
       RegressionResults baselineRegression = simplifiedLinearRegression(time, data, 0, baselinePoints_);
 
       // remove baseline
       std::vector<float> dataCorrected(data.size());
       for (unsigned int i = 0; i < data.size(); ++i)
         dataCorrected[i] = data[i] - (baselineRegression.q + baselineRegression.m * time[i]);
 
       auto max_corrected_it = std::max_element(dataCorrected.begin(), dataCorrected.end());
 
       float t = TotemTimingRecHit::NO_T_AVAILABLE;
 
       //if det==diamond then if (*min_it) > saturationLimit_), calculate the t, otherwise t=-100
       //if det==ufsd then if (*max_it) < saturationLimit_), calculate the t, otherwise t=-100
       //the difference between ufsd and sampic conditions comes from the signal flip
       if ((det->name() == "CTPPS_Diamond_Segment" && (*min_it) > saturationLimit_) ||
           (det->name() == "CTPPS_UFSD_Segment" && (*max_it) < saturationLimit_))
         t = constantFractionDiscriminator(time, dataCorrected);
       mode_ = TotemTimingRecHit::CFD;
       rec_hits.emplace_back(x_pos,
                             x_width,
                             y_pos,
                             y_width,
                             z_pos,
                             z_width,
                             t,
                             triggerCellTimeInstant,
                             timePrecision,
                             *max_corrected_it,
                             baselineRegression.rms,
                             mode_);
     }
   }
 }

◆ constantFractionDiscriminator()

float TotemTimingRecHitProducerAlgorithm::constantFractionDiscriminator	(	const std::vector< float > &	time,
		const std::vector< float > &	data
	)

private

Definition at line 187 of file TotemTimingRecHitProducerAlgorithm.cc.

References baselinePoints_, cfdFraction_, data, fastDiscriminator(), nano_mu_digi_cff::float, mps_fire::i, dqmiolumiharvest::j, lowPassFrequency_, SiStripPI::max, TotemTimingRecHit::NO_T_AVAILABLE, funct::sin(), SINC_COEFFICIENT, smoothingPoints_, DiMuonV_cfg::threshold, hcalRecHitTable_cff::time, and x.

Referenced by build().

                                                                                                       {
   std::vector<float> dataProcessed(data);
   if (lowPassFrequency_ != 0)  // Smoothing
     for (unsigned short i = 0; i < data.size(); ++i)
       for (unsigned short j = -smoothingPoints_ / 2; j <= +smoothingPoints_ / 2; ++j)
         if ((i + j) >= 0 && (i + j) < data.size() && j != 0) {
           float x = SINC_COEFFICIENT * lowPassFrequency_ * j;
           dataProcessed[i] += data[i + j] * std::sin(x) / x;
         }
   auto max_it = std::max_element(dataProcessed.begin(), dataProcessed.end());
   float max = *max_it;
 
   float threshold = cfdFraction_ * max;
   int indexOfThresholdCrossing = fastDiscriminator(dataProcessed, threshold);
 
   //--- necessary sanity checks before proceeding with the extrapolation
   return (indexOfThresholdCrossing >= 1 && indexOfThresholdCrossing >= baselinePoints_ &&
           indexOfThresholdCrossing < (int)time.size())
              ? (time[indexOfThresholdCrossing - 1] - time[indexOfThresholdCrossing]) /
                        (dataProcessed[indexOfThresholdCrossing - 1] - dataProcessed[indexOfThresholdCrossing]) *
                        (threshold - dataProcessed[indexOfThresholdCrossing]) +
                    time[indexOfThresholdCrossing]
              : (float)TotemTimingRecHit::NO_T_AVAILABLE;
 }

◆ fastDiscriminator()

int TotemTimingRecHitProducerAlgorithm::fastDiscriminator	(	const std::vector< float > &	data,
		float	threshold
	)		const

private

Definition at line 157 of file TotemTimingRecHitProducerAlgorithm.cc.

References data, hysteresis_, mps_fire::i, and DiMuonV_cfg::threshold.

Referenced by constantFractionDiscriminator().

                                                                                                              {
   int threholdCrossingIndex = -1;
   bool above = false;
   bool lockForHysteresis = false;
 
   for (unsigned int i = 0; i < data.size(); ++i) {
     // Look for first edge
     if (!above && !lockForHysteresis && data[i] > threshold) {
       threholdCrossingIndex = i;
       above = true;
       lockForHysteresis = true;
     }
     if (above && lockForHysteresis)  // NOTE: not else if!, "above" can be set in
                                      // the previous if
     {
       // Lock until above threshold_+hysteresis
       if (lockForHysteresis && data[i] > threshold + hysteresis_)
         lockForHysteresis = false;
       // Ignore noise peaks
       if (lockForHysteresis && data[i] < threshold) {
         above = false;
         lockForHysteresis = false;
         threholdCrossingIndex = -1;  // assigned because of noise
       }
     }
   }
 
   return threholdCrossingIndex;
 }

◆ setCalibration()

void TotemTimingRecHitProducerAlgorithm::setCalibration ( const PPSTimingCalibration & calib )

Definition at line 34 of file TotemTimingRecHitProducerAlgorithm.cc.

References l1tEGammaCrystalsEmulatorProducer_cfi::calib, mergeTimePeaks_, sampicConversions_, and sampicSamplingPeriodNs_.

Referenced by TotemTimingRecHitProducer::produce().

                                                                                          {
   sampicConversions_ = std::make_unique<TotemTimingConversions>(sampicSamplingPeriodNs_, mergeTimePeaks_, calib);
 }

◆ simplifiedLinearRegression()

TotemTimingRecHitProducerAlgorithm::RegressionResults TotemTimingRecHitProducerAlgorithm::simplifiedLinearRegression	(	const std::vector< float > &	time,
		const std::vector< float > &	data,
		const unsigned int	start_at,
		const unsigned int	points
	)		const

private

Definition at line 118 of file TotemTimingRecHitProducerAlgorithm.cc.

References data, mps_fire::i, SiStripPI::min, GetRecoTauVFromDQM_MC_cff::next, funct::pow(), mysort::results, mathSSE::sqrt(), fftjetcommon_cfi::sx, fftjetcommon_cfi::sy, and hcalRecHitTable_cff::time.

Referenced by build().

                                      {
   RegressionResults results;
   if (time.size() != data.size())
     return results;
   if (start_at > time.size())
     return results;
   unsigned int stop_at = std::min((unsigned int)time.size(), start_at + points);
   unsigned int realPoints = stop_at - start_at;
   auto t_begin = std::next(time.begin(), start_at);
   auto t_end = std::next(time.begin(), stop_at);
   auto d_begin = std::next(data.begin(), start_at);
   auto d_end = std::next(data.begin(), stop_at);
 
   const float sx = std::accumulate(t_begin, t_end, 0.);
   const float sxx = std::inner_product(t_begin, t_end, t_begin, 0.);  // sum(t**2)
   const float sy = std::accumulate(d_begin, d_end, 0.);
 
   float sxy = 0.;
   for (unsigned int i = 0; i < realPoints; ++i)
     sxy += time[i] * data[i];
 
   // y = mx + q
   results.m = (sxy * realPoints - sx * sy) / (sxx * realPoints - sx * sx);
   results.q = sy / realPoints - results.m * sx / realPoints;
 
   float correctedSyy = 0.;
   for (unsigned int i = 0; i < realPoints; ++i)
     correctedSyy += pow(data[i] - (results.m * time[i] + results.q), 2);
   results.rms = sqrt(correctedSyy / realPoints);
 
   return results;
 }