ldmx::HgcrocEmulator::CompositePulse Class Reference

CompositePulse. More...

Public Member Functions
	CompositePulse (TF1 &func, const double &g, const double &p)
	Constructore.
void	addOrMerge (const std::pair< double, double > &hit, double hit_merge_ns)
	Put another hit into this composite pulse.
double	findCrossing (double low, double high, double level, double prec=0.01)
	Find the time at which we cross the input level.
void	setGainPedestal (double gain, double pedestal)
	Configure the pulses for the current chip.
double	operator() (double time) const
	Evaluating this object as a function gives the same result as at.
double	at (double time) const
	Measure the voltage at the input time.
const std::vector< std::pair< double, double > > &	hits () const
	Get list of individual pulses that are entering the chip.

Private Attributes
std::vector< std::pair< double, double > >	hits_
	pulses entering the chip
TF1 &	pulseFunc_
	reference to pulse shape function shared by all pulses
double	gain_
	gain for current chip we are emulating
double	pedestal_
	pedestal for current chip we are emulating

Detailed Description

CompositePulse.

An emulator for a pulse that the chip needs to read. This handles merging two hits that are "close-enough" to one another.

Definition at line 236 of file HgcrocEmulator.h.

Constructor & Destructor Documentation

CompositePulse()

ldmx::HgcrocEmulator::CompositePulse::CompositePulse ( TF1 &  func, const double &  g, const double &  p  )

inline

Constructore.

Connect this pulse emulator with the pulse shape function already configured by the chip emulator.

Definition at line 245 of file HgcrocEmulator.h.

        : pulseFunc_{func}, gain_{g}, pedestal_{p} {}

Member Function Documentation

addOrMerge()

void ldmx::HgcrocEmulator::CompositePulse::addOrMerge ( const std::pair< double, double > &  hit, double  hit_merge_ns  )

inline

Put another hit into this composite pulse.

If the hit is within the merge input of a hit already included, then it is merged with that hit. Otherwise, it is included as its own hit.

Parameters

[in]	hit	voltage,time pair representing a sime hit
[in]	hit_merge_ns	maximum time separation [ns] to merge two hits

Definition at line 258 of file HgcrocEmulator.h.

                                                                             {
      auto imerge{hits_.begin()};
      for (; imerge != hits_.end(); imerge++)
        if (fabs(imerge->second - hit.second) < hit_merge_ns) break;
      if (imerge == hits_.end()) {  // didn't find a match, add to the list
        hits_.push_back(hit);
      } else {  // merge hits, shifting time to average
        imerge->second =
            (imerge->second * imerge->first + hit.first * hit.second);
        imerge->first += hit.first;
        imerge->second /= imerge->first;
      }
    }

References hits_.

Referenced by ldmx::HgcrocEmulator::digitize().

at()

double ldmx::HgcrocEmulator::CompositePulse::at ( double  time ) const

inline

Measure the voltage at the input time.

Includes the effects from all pulses but does not put any noise into the measurement.

Parameters

[in]

time

time to measure [ns]

Returns

voltage at that time [mV]

Definition at line 325 of file HgcrocEmulator.h.

                                 {
      double signal = gain_ * pedestal_;
      for (auto hit : hits_)
        signal += hit.first * pulseFunc_.Eval(time - hit.second);
      return signal;
    };

References gain_, hits_, pedestal_, and pulseFunc_.

Referenced by findCrossing(), and operator()().

findCrossing()

double ldmx::HgcrocEmulator::CompositePulse::findCrossing ( double  low, double  high, double  level, double  prec = 0.01  )

inline

Find the time at which we cross the input level.

We use the midpoint algorithm, assuming the input low is below the threshold and hight is above.

Parameters

[in]	low	minimum value (below threshold) to start search at [mV]
[in]	high	maximum value (above threshold) to start search at [mV]
[in]	level	threshold to look for time [mV]
[in]	prec	precision with which to look [mV]

Returns

time [ns] at which the pulse cross level

Definition at line 284 of file HgcrocEmulator.h.

                                            {
      // use midpoint algorithm, assumes low is below and high is above
      double step = high - low;
      double pt = (high + low) / 2;
      while (step > prec) {
        double vmid = at(pt);
        if (vmid < level) {
          low = pt;
        } else {
          high = pt;
        }
        step = high - low;
        pt = (high + low) / 2;
      }
      return pt;
    }

References at().

Referenced by ldmx::HgcrocEmulator::digitize().

hits()

const std::vector< std::pair< double, double > > & ldmx::HgcrocEmulator::CompositePulse::hits ( ) const

inline

Get list of individual pulses that are entering the chip.

Definition at line 333 of file HgcrocEmulator.h.

{ return hits_; }

References hits_.

Referenced by ldmx::HgcrocEmulator::digitize().

operator()()

double ldmx::HgcrocEmulator::CompositePulse::operator() ( double  time ) const

inline

Evaluating this object as a function gives the same result as at.

See also

at

Definition at line 314 of file HgcrocEmulator.h.

{ return at(time); }

References at().

setGainPedestal()

void ldmx::HgcrocEmulator::CompositePulse::setGainPedestal ( double  gain, double  pedestal  )

inline

Configure the pulses for the current chip.

Definition at line 303 of file HgcrocEmulator.h.

                                                       {
      gain_ = gain;
      pedestal_ = pedestal;
    }

References ldmx::HgcrocEmulator::gain(), gain_, ldmx::HgcrocEmulator::pedestal(), and pedestal_.

Member Data Documentation

gain_

double ldmx::HgcrocEmulator::CompositePulse::gain_

private

gain for current chip we are emulating

Definition at line 347 of file HgcrocEmulator.h.

Referenced by at(), and setGainPedestal().

hits_

std::vector<std::pair<double, double> > ldmx::HgcrocEmulator::CompositePulse::hits_

private

pulses entering the chip

The pair is {voltage amplitude [mV], time of peak [ns]}

Definition at line 341 of file HgcrocEmulator.h.

Referenced by addOrMerge(), at(), and hits().

pedestal_

double ldmx::HgcrocEmulator::CompositePulse::pedestal_

private

pedestal for current chip we are emulating

Definition at line 350 of file HgcrocEmulator.h.

Referenced by at(), and setGainPedestal().

pulseFunc_

TF1& ldmx::HgcrocEmulator::CompositePulse::pulseFunc_

private

reference to pulse shape function shared by all pulses

Definition at line 344 of file HgcrocEmulator.h.

Referenced by at().

---

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

• Tools/include/Tools/HgcrocEmulator.h