housing of higher-level methods for repeatable tasks More...

Classes
class	DataFitter
	Data class that stores information about each point in a 1d space. More...

Functions
std::array< int, 72 >	get_calibs (Target *tgt, ROC &roc, size_t &n_events, int &target_adc)
	Find calib value where the max adc corresponds to a target value.

std::array< double, 72 >	get_toa_efficiencies (const std::vector< pflib::packing::MultiSampleECONDEventPacket > &data)
	calculate the highest TOA_VREF value for each link, for which there is a non-zero TOA efficiency

std::map< std::string, std::map< std::string, uint64_t > >	inv_vref_lund (Target *tgt, ROC &roc)
	Find the inv_vref parameters.

static int	get_adc (const pflib::packing::MultiSampleECONDEventPacket &p, int ch)
	Retrieve the ADC sample for the input channel from the input event packet.

static std::array< int, 72 >	get_adc_medians (const std::vector< pflib::packing::MultiSampleECONDEventPacket > &data)
	get the medians of the channel ADC values

std::map< std::string, std::map< std::string, uint64_t > >	level_pedestals (Target *tgt, ROC roc)
	Level pedestals so that they are all within noise of their link median.

std::map< std::string, std::map< std::string, uint64_t > >	toa_vref_scan (Target *tgt, ROC roc)
	Find TOA threshold voltage reference to align TOA values.

std::map< std::string, std::map< std::string, uint64_t > >	tot_vref_scan (Target *tgt, ROC roc, size_t n_events_calib)
	Find TOT threshold voltage.

double	eff_scan (Target *tgt, ROC &roc, int &channel, int &vref_value, size_t &n_events, auto &refvol_page, auto &buffer, int &i_link)

int	global_vref_scan (Target *tgt, ROC &roc, int &channel, size_t &n_events, auto &refvol_page, auto &buffer, int &i_link)

int	local_vref_scan (Target *tgt, ROC &roc, int &channel, int &vref_value, size_t &n_events, auto &refvol_page, auto &buffer, int &i_link)

std::array< int, 2 >	tp50_scan (Target *tgt, ROC &roc, size_t &n_events, std::array< int, 72 > &calibs, std::array< int, 2 > &link_vref_list)
	Find TOT threshold voltage that corresponds to 50% efficiency for a given pulse.

std::map< std::string, std::map< std::string, uint64_t > >	trim_toa_scan (Target *tgt, ROC roc)
	Find trim_toa to align TOA for each channel.

std::array< int, 72 >	trim_tot_scan (Target *tgt, ROC &roc, size_t &n_events, std::array< int, 72 > &calibs, std::array< int, 2 > &tot_vrefs, std::array< int, 72 > &tot_trims)
	Find trim_toa to align TOA for each channel.

Detailed Description

housing of higher-level methods for repeatable tasks

Calculate the TRIM_TOA for each channel that best aligns all of them to a common threshold voltage, charge injection pulse (calib).

Note: Not currently operational, but a good place to pickup from.

Function Documentation

◆ get_adc_medians()

static std::array< int, 72 > pflib::algorithm::get_adc_medians ( const std::vector< pflib::packing::MultiSampleECONDEventPacket > & data )

static

get the medians of the channel ADC values

This may be helpful in some other contexts, but since it depends on the packing library it cannot go into utility. Just keeping it here for now, maybe move it into its own header/impl in algorithm.

Parameters

[in] data buffer of single-roc packet data

Returns: array of channel ADC values

Note: We assume the caller knows what they are doing. Calib and Common Mode channels are ignored. TOT/TOA and the sample Tp/Tc flags are ignored.

reserve a vector of the appropriate size to avoid repeating allocation time for all 72 channels

◆ get_calibs()

std::array< int, 72 > pflib::algorithm::get_calibs	(	Target *	tgt,
		ROC &	roc,
		size_t &	n_events,
		int &	target_adc )

Find calib value where the max adc corresponds to a target value.

Parameters

[in] tgt pointer to Target to interact with roc for setting params target calib value

reserve a vector of the appropriate size to avoid repeating allocation time for all 72 channels

◆ get_toa_efficiencies()

std::array< double, 72 > pflib::algorithm::get_toa_efficiencies ( const std::vector< pflib::packing::MultiSampleECONDEventPacket > & data )

calculate the highest TOA_VREF value for each link, for which there is a non-zero TOA efficiency

reserve a vector of the appropriate size to avoid repeating allocation time for all 72 channels

we assume that the data provided is not empty otherwise the efficiency calculation is meaningless

◆ inv_vref_lund()

std::map< std::string, std::map< std::string, uint64_t > > pflib::algorithm::inv_vref_lund	(	Target *	tgt,
		ROC &	roc )

Find the inv_vref parameters.

The noinv_vref parameters are hardcoded to 612 for each link.

Parameters

[in] tgt pointer to Target to interact with

Note: Only functional for single-ROC targets

◆ level_pedestals()

std::map< std::string, std::map< std::string, uint64_t > > pflib::algorithm::level_pedestals	(	Target *	tgt,
		ROC	roc )

Level pedestals so that they are all within noise of their link median.

Parameters

[in] tgt pointer to Target to interact with

Note: Only functional for single-ROC targets

do three runs of 100 samples each to have well defined pedestals

TODO for multi-ROC set ups, we could dynamically determine the number

◆ toa_vref_scan()

std::map< std::string, std::map< std::string, uint64_t > > pflib::algorithm::toa_vref_scan	(	Target *	tgt,
		ROC	roc )

Find TOA threshold voltage reference to align TOA values.

Parameters

[in] tgt pointer to Target to interact with

Note: Only functional for single-ROC targets

do a run of 100 samples per toa_vref to measure the TOA efficiency when looking at pedestal data

◆ tot_vref_scan()

std::map< std::string, std::map< std::string, uint64_t > > pflib::algorithm::tot_vref_scan	(	Target *	tgt,
		ROC	roc,
		size_t	n_events_calib )

Find TOT threshold voltage.

Parameters

[in] tgt pointer to Target to interact with

Note: Only functional for single-ROC targets

◆ tp50_scan()

std::array< int, 2 > pflib::algorithm::tp50_scan	(	Target *	tgt,
		ROC &	roc,
		size_t &	n_events,
		std::array< int, 72 > &	calibs,
		std::array< int, 2 > &	link_vref_list )

Find TOT threshold voltage that corresponds to 50% efficiency for a given pulse.

Parameters

[in] tgt pointer to Target to interact with roc calib: target calib tot_vref: previously set tot_vref

Note: Only functional for single-ROC targets

◆ trim_toa_scan()

std::map< std::string, std::map< std::string, uint64_t > > pflib::algorithm::trim_toa_scan	(	Target *	tgt,
		ROC	roc )

Find trim_toa to align TOA for each channel.

Parameters

[in] tgt pointer to Target to interact with

Note: Only functional for single-ROC targets

Charge injection scan (100 samples) while varying TRIM_TOA. Purpose is to align TRIM_TOA for each channel. Calculates TOA efficiency while looking at charge injection data. Then uses Siegel Linear Regression to calculate the aligned TRIM_TOA value for each channel to match a common "calib" value.

Note: Reduce the sample size (ex: 100 to 10) to decrease the scan time.

Now that we have the data, we need to analyze it.

We'll be looking for the turn-on (threshold) points for each channel at each trim_toa value. The turn-on (threshold) point is the first point where toa_efficiency goes from 0 to non-zero. The toa_efficiency is simply the number of times TOA triggers divided by the sample size, for a given trim_toa/calib/channel combination.

We'll be using the Siegel Linear Regression because it's less sensitive to outliers, since sometimes changing the trim_toa causes the threshold (turn-on) points to "wrap around".

◆ trim_tot_scan()

std::array< int, 72 > pflib::algorithm::trim_tot_scan	(	Target *	tgt,
		ROC &	roc,
		size_t &	n_events,
		std::array< int, 72 > &	calibs,
		std::array< int, 2 > &	tot_vrefs,
		std::array< int, 72 > &	tot_trims )

Find trim_toa to align TOA for each channel.

Parameters

[in] tgt pointer to Target to interact with

Note: Only functional for single-ROC targets

Classes

Functions

Detailed Description

Function Documentation

◆ get_adc_medians()

◆ get_calibs()

◆ get_toa_efficiencies()

◆ inv_vref_lund()

◆ level_pedestals()

◆ toa_vref_scan()

◆ tot_vref_scan()

◆ tp50_scan()

◆ trim_toa_scan()

◆ trim_tot_scan()