ldmx::CompositePulse Class Reference

CompositePulse. More...

#include <CompositePulse.h>

Public Member Functions
	CompositePulse (TF1 func, const double &gain, const double &pedestal)
	Constructore.
void	clear ()
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 Member Functions
	ClassDef (CompositePulse, 2)

Private Attributes
std::vector< std::pair< double, double > >	hits_
	pulses entering the chip
TF1	pulse_func_
	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 18 of file CompositePulse.h.

Constructor & Destructor Documentation

CompositePulse()

ldmx::CompositePulse::CompositePulse ( TF1 func, const double & gain, const double & pedestal )

inline

Constructore.

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

Definition at line 27 of file CompositePulse.h.

      : pulse_func_{func}, gain_{gain}, pedestal_{pedestal} {}

Member Function Documentation

addOrMerge()

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

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 6 of file CompositePulse.cxx.

                                                     {
  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::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 86 of file CompositePulse.h.

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

References gain_, hits_, pedestal_, and pulse_func_.

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

clear()

void ldmx::CompositePulse::clear ( )

inline

Definition at line 34 of file CompositePulse.h.

{};

findCrossing()

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

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 20 of file CompositePulse.cxx.

                                                 {
  // 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::CompositePulse::hits ( ) const

inline

Get list of individual pulses that are entering the chip.

Definition at line 94 of file CompositePulse.h.

{ return hits_; }

References hits_.

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

operator()()

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

inline

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

See also

at

Definition at line 75 of file CompositePulse.h.

{ return at(time); }

References at().

setGainPedestal()

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

inline

Configure the pulses for the current chip.

Definition at line 64 of file CompositePulse.h.

                                                     {
    gain_ = gain;
    pedestal_ = pedestal;
  }

References gain_, and pedestal_.

Member Data Documentation

gain_

double ldmx::CompositePulse::gain_

private

gain for current chip we are emulating

Definition at line 108 of file CompositePulse.h.

Referenced by at(), and setGainPedestal().

hits_

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

private

pulses entering the chip

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

Definition at line 102 of file CompositePulse.h.

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

pedestal_

double ldmx::CompositePulse::pedestal_

private

pedestal for current chip we are emulating

Definition at line 111 of file CompositePulse.h.

Referenced by at(), and setGainPedestal().

pulse_func_

TF1 ldmx::CompositePulse::pulse_func_

private

reference to pulse shape function shared by all pulses

Definition at line 105 of file CompositePulse.h.

Referenced by at().

---

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

• Recon/include/Recon/Event/CompositePulse.h
• Recon/src/Recon/Event/CompositePulse.cxx