top modules

Classes
class	TOPAlignmentCollectorModule
	Collector for geometrical alignment of a TOP module with dimuons or Bhabhas. More...
class	TOPAsicShiftsBS13dCollectorModule
	Collector for carrier shifts of BS13d. More...
class	TOPChannelMaskCollectorModule
	Collector for preparing masks of hot and dead channels. More...
class	TOPCommonT0BFCollectorModule
	Collector for common T0 calibration with a fit of bunch finder residuals (method BF) More...
class	TOPCommonT0LLCollectorModule
	Collector for common T0 calibration with neg. More...
class	TOPModuleT0DeltaTCollectorModule
	Collector for module T0 calibration with chi2 minimization of time differences between slots (method DeltaT). More...
class	TOPModuleT0LLCollectorModule
	Collector for module T0 calibration with neg. More...
class	TOPOffsetCollectorModule
	Collector for eventT0 and fill pattern offset calibrations. More...
class	TOPPhotonYieldsCollectorModule
	Collector for photon pixel yields aimed for PMT ageing studies and for finding optically decoupled PMT's. More...
class	TOPPulseHeightCollectorModule
	Collector for channel pulse-height distributions. More...
class	TOPValidationCollectorModule
	Collector for automatic validation of calibration with dimuon events. More...
class	OpticalGunModule
	Source of optical photons for the simulation of the TOP laser system. More...
class	TOPAlignerModule
	Alignment of TOP. More...
class	TOPBackgroundModule
	TOP backgound module. More...
class	TOPBunchFinderModule
	Bunch finder: searches for the bunch crossing where the interaction happened using track-based TOP likelihood. More...
class	TOPChannelMaskerModule
	Masks dead PMs from the reconstruction. More...
class	TOPChannelT0CalibratorModule
	A module for alternative channel T0 calibration with collision data Note: after this kind of calibration one cannot do the geometrical alignment This module can also be used to check the calibration. More...
class	TOPChannelT0MCModule
	TOP Channel T0 MC Extraction module (under development) More...
class	TOPCommonT0CalibratorModule
	A module for common T0 calibration with collision data (dimuons or bhabhas) More...
class	TOPCosmicT0FinderModule
	Event T0 finder for global cosmic runs. More...
class	TOPDigitizerModule
	TOP digitizer. More...
class	TOPTriggerDigitizerModule
	Digitizer that provides time stamps for TOP trigger. More...
class	TOPCalPulseGeneratorModule
	Generator of calibration pulses Output to TOPSimCalPulses. More...
class	TOPDoublePulseGeneratorModule
	Generator of double calibration pulses Output to TOPDigits. More...
class	TOPDQMModule
	TOP DQM histogrammer. More...
class	TOPGainEfficiencyCalculatorModule
	Module for channel-by-channel gain/efficiency analysis. More...
class	TOPLaserHitSelectorModule
	Module for pixel-by-pixel gain/efficiency analysis. More...
class	TOPGeometryParInitializerModule
	Class for initializing TOPGeometryPar. More...
class	TOPInterimFENtupleModule
	Module to produce ntuple from TOPDigits and TOPRawDigits. More...
class	TOPLaserCalibratorModule
	T0 Laser calibration module (under development) More...
class	TOPLaserCalibratorCollectorModule
	Collector module for the TOP channelT0 calibration and, more in general, for the time resolution studies using the laser and pulser data. More...
class	TOPLLScannerModule
	A module to perform the TOP PID likelihood scan and find the actual minimum as function of the mass. More...
class	TOPMCTrackMakerModule
	Constructs Tracks and ExtHits from MCParticles and TOPBarHits Utility needed for testing and debugging of TOP reconstruction. More...
class	TOPModuleT0CalibratorModule
	A module for module T0 calibration with collision data (dimuons or bhabhas) Useful when the geometrical alignment need not to be repeated. More...
class	TOPNtupleModule
	Module to write out a ntuple summarizing TOP reconstruction output. More...
class	TOPPackerModule
	Raw data packer. More...
class	TOPPDFCheckerModule
	Module for checking analytic PDF used in likelihood calculation. More...
class	TOPPDFDebuggerModule
	TOP reconstruction module. More...
class	TOPRawDigitConverterModule
	TOPRawDigits to TOPDigits converter. More...
class	TOPReconstructorModule
	TOP reconstruction module. More...
class	TOPRingPlotterModule
	A module to plot the x-t images from TOP, and in general study the distribution of the digits associated to the particles in a particleList. More...
class	TOPTBCComparatorModule
	Module for the comparison of different sets of time base correction (TBC) constants and to produce monitoring plots out of a given set. More...
struct	Hit
	Structure to hold some of the calpulse data. More...
struct	TwoTimes
	Structure to hold calpulse raw times expressed in samples since sample 0 of window 0. More...
class	TOPTimeBaseCalibratorModule
	Time base calibrator. More...
class	TOPTimeRecalibratorModule
	Utility module for re-calibrating time of TOPDigits pulseWidth and timeError are not changed although they may depend no calibration! More...
class	TOPUnpackerModule
	Raw data unpacker. More...
class	TOPWaveformFeatureExtractorModule
	Waveform feature extractor: module adds rawDigits that are found in waveforms by feature extraction but are not already present in RawDigits. More...
class	TOPWaveformQualityPlotterModule
	Plots and histograms of waveforms and feature extracted parameters. More...
class	TOPXTalkChargeShareSetterModule
	Crosstalk & chargeshare flag setter. More...

Enumerations
enum	{   c_NChannelPerAsic = 8 ,   c_NModule = 16 ,   c_NChannelPerPMT = 16 ,   c_NChannelPerPMTRow = 4 ,   c_NPMTPerRow = 16 ,   c_NPMTPerModule = 32 ,   c_NPixelPerRow = 64 ,   c_NPixelPerModule = 512 }
	enum for maximum number of array elements (# of hits per event) More...

Functions
	REG_MODULE (TOPAlignmentCollector)
	Register module.
	REG_MODULE (TOPAsicShiftsBS13dCollector)
	Register module.
	REG_MODULE (TOPChannelMaskCollector)
	Register module.
	REG_MODULE (TOPCommonT0BFCollector)
	Register module.
	REG_MODULE (TOPCommonT0LLCollector)
	Register module.
	REG_MODULE (TOPModuleT0DeltaTCollector)
	Register module.
	REG_MODULE (TOPModuleT0LLCollector)
	Register module.
	REG_MODULE (TOPOffsetCollector)
	Register module.
	REG_MODULE (TOPPhotonYieldsCollector)
	Register module.
	REG_MODULE (TOPPulseHeightCollector)
	Register module.
	REG_MODULE (TOPValidationCollector)
	Register module.
	REG_MODULE (OpticalGun)
	Register module.
	REG_MODULE (TOPAligner)
	Register module.
	REG_MODULE (TOPBackground)
	Register the Module.
	REG_MODULE (TOPBunchFinder)
	Register module.
	REG_MODULE (TOPChannelMasker)
	Register the Module.
	REG_MODULE (TOPChannelT0Calibrator)
	Register module.
	REG_MODULE (TOPChannelT0MC)
	Register module.
	REG_MODULE (TOPCommonT0Calibrator)
	Register module.
	REG_MODULE (TOPCosmicT0Finder)
	Register module.
	REG_MODULE (TOPDigitizer)
	Register the Module.
	REG_MODULE (TOPTriggerDigitizer)
	Register the Module.
	REG_MODULE (TOPCalPulseGenerator)
	Register module.
	REG_MODULE (TOPDoublePulseGenerator)
	Register module.
	REG_MODULE (TOPDQM)
	Register module.
	REG_MODULE (TOPGainEfficiencyCalculator)
	Register the Module.
	REG_MODULE (TOPLaserHitSelector)
	Register the Module.
	REG_MODULE (TOPGeometryParInitializer)
	Register module.
	REG_MODULE (TOPInterimFENtuple)
	Register module.
	REG_MODULE (TOPLaserCalibrator)
	Register module.
	REG_MODULE (TOPMCTrackMaker)
	Register module.
	REG_MODULE (TOPModuleT0Calibrator)
	Register module.
	REG_MODULE (TOPNtuple)
	Register module.
	REG_MODULE (TOPPacker)
	Register module.
	REG_MODULE (TOPPDFChecker)
	Register module.
	REG_MODULE (TOPPDFDebugger)
	Register the Module.
	REG_MODULE (TOPRawDigitConverter)
	Register module.
	REG_MODULE (TOPReconstructor)
	Register the Module.
	REG_MODULE (TOPTBCComparator)
	Register module.
	REG_MODULE (TOPTimeBaseCalibrator)
	Register module.
	REG_MODULE (TOPTimeRecalibrator)
	Register module.
	REG_MODULE (TOPUnpacker)
	Register module.
	REG_MODULE (TOPWaveformFeatureExtractor)
	Register module.
	REG_MODULE (TOPWaveformQualityPlotter)
	Register module.
	TOPAlignmentCollectorModule ()
	Constructor.
virtual void	prepare () final
	Replacement for initialize().
virtual void	collect () final
	Replacement for event().
	TOPAsicShiftsBS13dCollectorModule ()
	Constructor.
virtual void	prepare () final
	Replacement for initialize().
virtual void	collect () final
	Replacement for event().
	TOPChannelMaskCollectorModule ()
	Constructor.
virtual void	prepare () final
	Replacement for initialize().
virtual void	collect () final
	Replacement for event().
	TOPCommonT0BFCollectorModule ()
	Constructor.
virtual void	prepare () final
	Replacement for initialize().
virtual void	collect () final
	Replacement for event().
	TOPCommonT0LLCollectorModule ()
	Constructor.
virtual void	prepare () final
	Replacement for initialize().
virtual void	collect () final
	Replacement for event().
	TOPModuleT0DeltaTCollectorModule ()
	Constructor.
virtual void	prepare () final
	Replacement for initialize().
virtual void	collect () final
	Replacement for event().
	TOPModuleT0LLCollectorModule ()
	Constructor.
virtual void	prepare () final
	Replacement for initialize().
virtual void	collect () final
	Replacement for event().
	TOPOffsetCollectorModule ()
	Constructor.
virtual void	prepare () final
	Replacement for initialize().
virtual void	collect () final
	Replacement for event().
	TOPPhotonYieldsCollectorModule ()
	Constructor.
virtual void	prepare () final
	Replacement for initialize().
virtual void	collect () final
	Replacement for event().
	TOPPulseHeightCollectorModule ()
	Constructor.
virtual void	prepare () final
	Replacement for initialize().
virtual void	collect () final
	Replacement for event().
	TOPValidationCollectorModule ()
	Constructor.
virtual void	prepare () final
	Replacement for initialize().
virtual void	startRun () final
	Replacement for beginRun().
virtual void	collect () final
	Replacement for event().
virtual void	closeRun () final
	Replacement for endRun().
	OpticalGunModule ()
	Constructor.
virtual	~OpticalGunModule ()
	Destructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	event () override
	Event processor.
bool	isInsideSlit (const ROOT::Math::XYZPoint &point, const ROOT::Math::XYZVector &direction) const
	Checks if photon passes the slit.
ROOT::Math::XYZVector	getDirectionGaussian () const
	Return photon direction according to a projected 2D gaussian distribution based on numerical aperture NA.
ROOT::Math::XYZVector	getDirectionUniform () const
	Return photon direction according to a projected uniform distribution with opening angle alpha.
ROOT::Math::XYZVector	getDirectionLambertian () const
	Return photon direction according to a lambertian distribution with opening angle alpha.
ROOT::Math::XYZVector	getDirectionCustom () const
	Return photon direction according to a custom angular distribution given by TFormula.
	TOPAlignerModule ()
	Constructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	event () override
	Event processor.
virtual void	terminate () override
	Termination action.
	TOPBackgroundModule ()
	Constructor.
virtual	~TOPBackgroundModule ()
	Destructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
void	myprint (TH1F *histo, const char *path, const char *xtit, const char *ytit, double tresh)
	Print histogram 1D, helper function.
virtual void	endRun () override
	End-of-run action.
virtual void	terminate () override
	Termination action.
void	printModuleParams () const
	Prints module parameters.
	TOPBunchFinderModule ()
	Constructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
virtual void	terminate () override
	Termination action.
Const::ChargedStable	getMostProbable (const Track &track)
	Returns most probable charged stable particle according to dEdx and predefined prior probabilities.
int	setFinder (TOP::Chi2MinimumFinder1D &finder, const TOP::PDFConstructor &reco, double timeMin, double timeMax)
	Sets finder object with chi2 values.
TimeSeed	getTimeSeed ()
	Returns a time seed.
bool	isBucketFilled (int bunchNo)
	Does reconstructed bunch number correspond to filled bucket.
	TOPChannelMaskerModule ()
	Constructor: Sets the description of the module.
virtual void	initialize () override
	initialize method: registers datastore objects (the TOP hits)
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	event method: removes channels from the reconstruction pdf, flags hits from noisy channels as junk
	TOPChannelT0CalibratorModule ()
	Constructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	event () override
	Event processor.
virtual void	terminate () override
	Termination action.
	TOPChannelT0MCModule ()
	Constructor.
virtual	~TOPChannelT0MCModule ()
	Destructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
virtual void	endRun () override
	End-of-run action.
virtual void	terminate () override
	Termination action.
	TOPCommonT0CalibratorModule ()
	Constructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	event () override
	Event processor.
virtual void	terminate () override
	Termination action.
bool	isRunningOffsetSubtracted ()
	Checks if running offset is subtracted in TOPDigits.
	TOPCosmicT0FinderModule ()
	Constructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	event () override
	Event processor.
virtual void	terminate () override
	Termination action.
	TOPDigitizerModule ()
	Constructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
TimeOffset	getTimeOffset (double trgOffset, int moduleID, int pixelID)
	Returns a complete time offset by adding time mis-calibration to trgOffset.
double	generatePulseHeight (int moduleID, int pixelID) const
	Generates and returns pulse height.
	TOPTriggerDigitizerModule ()
	Constructor.
virtual	~TOPTriggerDigitizerModule ()
	Destructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
virtual void	endRun () override
	End-of-run action.
virtual void	terminate () override
	Termination action.
	TOPCalPulseGeneratorModule ()
	Constructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	event () override
	Event processor.
	TOPDoublePulseGeneratorModule ()
	Constructor.
virtual	~TOPDoublePulseGeneratorModule ()
	Destructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
virtual void	endRun () override
	End-of-run action.
virtual void	terminate () override
	Termination action.
void	storeSampleTimes (std::string fileName)
	Optionally store sample times used by the generator as root histograms fileName root output file name.
void	saveAsHistogram (const std::vector< double > &vec, const std::string &name, const std::string &title, const std::string &xTitle="", const std::string &yTitle="") const
	Save vector to histogram and write it out.
	TOPDQMModule ()
	Constructor.
virtual	~TOPDQMModule ()
	Destructor.
virtual void	defineHisto () override
	Histogram definitions such as TH1(), TH2(), TNtuple(), TTree()....
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
int	getModuleID (const Track &track) const
	Returns slot ID of the module that is hit by the track.
	TOPGainEfficiencyCalculatorModule ()
	Constructor.
virtual	~TOPGainEfficiencyCalculatorModule ()
	Destructor.
virtual void	initialize () override
	Load time vs charge 2D histogram from a given input file (paramter "inputFile") and prepare hit timing and pulse charge distribution for each channel.
virtual void	defineHisto () override
	Define TTree branches to store fit results for each channel This TTree is saved in an output file given by "histoFileName" parameter of "HistoManager" module.
virtual void	beginRun () override
	The main processes, fitting charge distribution and calculating gain/efficiency, are done in this function.
virtual void	event () override
	This will be empty as the all the processes are done in beginRun() function thus input file can be a dummy file.
virtual void	endRun () override
	Draw plots to show fitting results for each channel and save them into a given PDF file (outputPDFFile).
virtual void	terminate () override
	Termination action.
void	LoadHistograms (const std::string &histotype)
	Load 2D histograms from a given input file (output of TOPLaserHitSelector) and create timing and charge distribution as projection histograms for the x- and y-axis, respectively.
void	FitHistograms (EHistogramType LoadHisto)
	Fit charge (or integrated charged) distribution to calculate gain and efficiency for each channel.
void	DummyFillBranch (EHistogramType LoadHisto)
	Fill Dummy for Branch.
void	DrawResult (const std::string &histotype, EHistogramType LoadHisto)
	Draw results of gain/efficiency calculation for each channel to a given output file.
static double	TOPGainFunc (double *var, double *par)
	Fit function of pulse charge (or charnge) distribution for channel(pixel)-by-channel gain extraction, given by "[0]*pow(x-[4],[1])*exp(-pow(x-[4],[2])/[3])" smeared by Gaussian with a constant sigma to consider baseline fluctuation.
static double	FindPeakForSmallerXThan (TH1 *histo, double xmax=0)
	Find peak and return its position for a limited range of x (x smaller than the given value (xmax))
	TOPLaserHitSelectorModule ()
	Constructor.
virtual	~TOPLaserHitSelectorModule ()
	Destructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	defineHisto () override
	create timing-height 2D histograms for all 8192 pixels
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
virtual void	endRun () override
	End-of-run action.
virtual void	terminate () override
	Termination action.
	TOPGeometryParInitializerModule ()
	Constructor.
virtual void	initialize () override
	Initialize the Module.
	TOPInterimFENtupleModule ()
	Constructor.
virtual	~TOPInterimFENtupleModule ()
	Destructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	defineHisto () override
	Module funcions to define histograms.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
virtual void	endRun () override
	End-of-run action.
virtual void	terminate () override
	Termination action.
void	getReferenceTiming ()
	Find reference timing.
	TOPLaserCalibratorModule ()
	Constructor.
virtual	~TOPLaserCalibratorModule ()
	Destructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
virtual void	endRun () override
	End-of-run action.
virtual void	terminate () override
	Termination action.
	TOPMCTrackMakerModule ()
	Constructor.
virtual	~TOPMCTrackMakerModule ()
	Destructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
virtual void	endRun () override
	End-of-run action.
virtual void	terminate () override
	Termination action.
	TOPModuleT0CalibratorModule ()
	Constructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
virtual void	terminate () override
	Termination action.
bool	isRunningOffsetSubtracted ()
	Checks if running offset is subtracted in TOPDigits.
	TOPNtupleModule ()
	Constructor.
virtual	~TOPNtupleModule ()
	Destructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
virtual void	endRun () override
	End-of-run action.
virtual void	terminate () override
	Termination action.
	TOPPackerModule ()
	Constructor.
virtual	~TOPPackerModule ()
	Destructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
virtual void	endRun () override
	End-of-run action.
virtual void	terminate () override
	Termination action.
void	packProductionDraft ()
	Pack in format: c_Draft (tentative production format) this format was never implemented in firmware!
void	packType0Ver16 ()
	Pack in format: c_Type0Ver16 (Feature-extracted data) this format was never implemented in firmware!
void	packProductionDebug ()
	Pack in format: Production Debugging Data Format 01.
	TOPPDFCheckerModule ()
	Constructor.
virtual void	defineHisto () override
	Histogram definitions such as TH1(), TH2(), TNtuple(), TTree()....
virtual void	initialize () override
	Initialize the Module.
virtual void	event () override
	Event processor.
virtual void	terminate () override
	Termination action.
bool	isFromThisParticle (const TOPDigit &digit, const MCParticle *particle)
	Checks if digit comes from given MC particle.
	TOPPDFDebuggerModule ()
	Constructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	event () override
	Event processor.
void	associatePDFPeaks (const TOP::PDFConstructor &pdfConstructor)
	Associate PDF peaks with photons using S-plot technique.
	TOPRawDigitConverterModule ()
	Constructor.
virtual	~TOPRawDigitConverterModule ()
	Destructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
virtual void	endRun () override
	End-of-run action.
virtual void	terminate () override
	Termination action.
	TOPReconstructorModule ()
	Constructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	event () override
	Event processor.
	TOPTBCComparatorModule ()
	Constructor.
void	defineHisto () override
	Defining the histograms.
int	analyzeCalFile ()
	Analyzes the calibrations stored in the file m_calSetFile.
int	makeComparisons ()
	Last function to be called, compared the histograms of different datasets filled by analyzeCalFile() Every new comparison histogram added to the module has to be filled here.
void	initialize () override
	Initialize the module.
void	beginRun () override
	Called when entering a new run.
void	event () override
	Event processor.
void	endRun () override
	End-of-run action.
void	terminate () override
	Termination action.
int	parseInputDirectoryLine (std::string)
	Utility function to get the directory name and the label from a line of the m_inputDirectoryList file Sets the values of m_calSetDirectory and m_calSetLabel.
int	parseSlotAndScrodIDfromFileName (std::string)
	Utility function to parse the slot and BS id from the calibration file names.
TH1F *	calculateHistoRatio (TH1F *, TH1F *, TH1F *)
	Utility function to take the ratio of two histograms using TH1::Divide(), without overwriting the output name and title initialized in defineHisto().
TH2F *	calculateHistoRatio (TH2F *, TH2F *, TH2F *)
	Utility function to take the ratio of two histograms using TH2::Divide(), without overwriting the output name and title initialized in defineHisto().
	TOPTimeBaseCalibratorModule ()
	Constructor.
virtual	~TOPTimeBaseCalibratorModule ()
	Destructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
virtual void	endRun () override
	End-of-run action.
virtual void	terminate () override
	Termination action.
bool	calibrateChannel (std::vector< TwoTimes > &ntuple, unsigned scrodID, unsigned scrodChannel, TH1F &Hchi2, TH1F &Hndf, TH1F &HDeltaT)
	calibrate single channel
bool	matrixInversion (const std::vector< TwoTimes > &ntuple, unsigned scrodID, unsigned scrodChannel, double meanTimeDifference, TH1F &Hchi2, TH1F &Hndf, TH1F &HDeltaT)
	Method by matrix inversion.
bool	iterativeTBC (const std::vector< TwoTimes > &ntuple, unsigned scrodID, unsigned scrodChannel, double meanTimeDifference, TH1F &Hchi2, TH1F &Hndf, TH1F &HDeltaT)
	Method by iteration of chi2 minimization.
void	Iteration (const std::vector< TwoTimes > &ntuple, std::vector< double > &xval)
	Iteration function called by iterativeTBC()
double	Chisq (const std::vector< TwoTimes > &ntuple, const std::vector< double > &xxval)
	Return the chisqure of one set of TBC constants (xval) in iTBC calculaton.
void	saveAsHistogram (const std::vector< double > &vec, const std::string &name, const std::string &title, const std::string &xTitle="", const std::string &yTitle="") const
	Save vector to histogram and write it out.
void	saveAsHistogram (const std::vector< double > &vec, const std::vector< double > &err, const std::string &name, const std::string &title, const std::string &xTitle="", const std::string &yTitle="") const
	Save vector and errors to histogram and write it out.
void	saveAsHistogram (const TMatrixDSym &M, const std::string &name, const std::string &title) const
	Save matrix to histogram and write it out.
	TOPTimeRecalibratorModule ()
	Constructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
	TOPUnpackerModule ()
	Constructor.
virtual	~TOPUnpackerModule ()
	Destructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
std::string	getFrontEndName (RawTOP &raw, int finesse) const
	Returns the name of the front-end.
bool	printTheError ()
	Error messages suppression logic.
void	unpackProductionDraft (const int *buffer, int bufferSize)
	Unpack raw data given in a tentative production format (will vanish in future)
void	unpackType0Ver16 (const int *buffer, int bufferSize)
	Unpack raw data given in feature-extraction production format.
bool	unpackHeadersInterimFEVer01 (const int *buffer, int bufferSize, bool swapBytes)
	Tries to unpack raw data assuming it is in feature-extraction interim format.
int	unpackInterimFEVer01 (const int *buffer, int bufferSize, bool pedestalSubtracted)
	Unpack raw data given in feature-extraction interim format.
int	unpackProdDebug (const int *buffer, int bufferSize, TOP::RawDataType dataFormat, bool pedestalSubtracted)
	Unpack raw data given in production debugging format.
virtual void	endRun () override
	End-of-run action.
virtual void	terminate () override
	Termination action.
	TOPWaveformFeatureExtractorModule ()
	Constructor.
virtual	~TOPWaveformFeatureExtractorModule ()
	Destructor.
virtual void	initialize () override
	Initialize the Module.
virtual void	beginRun () override
	Called when entering a new run.
virtual void	event () override
	Event processor.
virtual void	endRun () override
	End-of-run action.
virtual void	terminate () override
	Termination action.
	TOPWaveformQualityPlotterModule ()
	Constructor.
void	defineHisto () override
	Books the empty histograms.
void	initialize () override
	Module initialization, calls defineHisto and gets waveform.
void	basicDebuggingPlots (const TOPRawWaveform &rawwave)
	Fills the debugging 1D histograms and hitmaps.
void	drawWaveforms (const TOPRawWaveform &rawwave)
	Draws the full waveforms onto the TProfiles.
void	event () override
	Event processor.
void	endRun () override
	End-of-run action.

Detailed Description

Enumeration Type Documentation

anonymous enum

anonymous enum

enum for maximum number of array elements (# of hits per event)

Definition at line 24 of file TOPLaserHitSelectorModule.h.

       { c_NChannelPerAsic = 8, c_NModule = 16, c_NChannelPerPMT = 16,
         c_NChannelPerPMTRow = 4, c_NPMTPerRow = 16,
         c_NPMTPerModule = 32, c_NPixelPerRow = 64, c_NPixelPerModule = 512
       };

Function Documentation

analyzeCalFile()

int analyzeCalFile

(

)

Analyzes the calibrations stored in the file m_calSetFile.

This is the main function in which the analysis and the hisogram filling takes place. Every new monitoring histogram added to the module has to be filled here.

Definition at line 207 of file TOPTBCComparatorModule.cc.

  {
    // Here the histograms are filled
    // WARNING! What root calls "RMS" is actually a standard deviation
 
    // Sanity check on the parsed parameters
    if (m_slotID < 0 || m_boardstackID < 0 || m_scrodID < 0) {
      B2WARNING("Negative slot, BS or scrod ID found while calling analyzeCalFile(). Looks like they have not been initialized, or that a function re-initialized them");
      return 0;
    }
 
    // Loop over all the histograms that should be found in the file
    for (short iChannel = 0; iChannel < 128; iChannel++) {
 
      // Pics up one histogram just to check that the channel iChannel was actually used to calculate the calibrations
      if (!m_calSetFile->Get(str(format("timeDiff_ch%1%") % (iChannel)).c_str())) {
        continue;
      }
 
 
      // ---------
      // 1) Define some channel numbering quantities
      // Watchout: m_slotID is in [1..16] so slot m_slotID is on the element m_slotID-1 of the array
      // ---------
 
      short hardwareChannel = iChannel + 128 * m_boardstackID; // 0-511 across the whole module, BS by BS
      auto& chMapper = TOP::TOPGeometryPar::Instance()->getChannelMapper();
      short pixelID = chMapper.getPixelID(hardwareChannel); // 1-512 across the whole module, in rows
      short colNum = (pixelID - 1) % 64 + 1; // 1- 64  column ID (right to left looking from the quartz to the PMTs)
      short rowNum = (pixelID - 1) / 64 + 1 ; // 1- 8 row ID (bottom to top looking from the quartz to the PMTs)
      short globalChannel = hardwareChannel + 512 * (m_slotID -
                                                     1); // channel number across the whole detector, 0-8191. Used for cal monitorin only
 
 
      // ---------
      // 2) Channel-by-channel DeltaT summaries (average on the 256 samples of each set)
      // ---------
 
      // Checks that the histogram needed here is not corrupted before using it
      if (!m_calSetFile->Get(str(format("timeDiffcal_ch%1%") % (iChannel)).c_str())) {
        B2WARNING("Error opening " << str(format("timeDiffcal_ch%1%") % (iChannel)));
      } else {
        TH2F* h_timeDiffcal = (TH2F*)m_calSetFile->Get(str(format("timeDiffcal_ch%1%") % (iChannel)).c_str());
        TH1D* h_projection = h_timeDiffcal->ProjectionY("h_projection", 1, m_numSamples); // full projection
 
        m_slotAverageDeltaT[m_slotID - 1][m_calSetID]->SetBinContent(hardwareChannel + 1, h_projection->GetMean());
        m_slotAverageDeltaT[m_slotID - 1][m_calSetID]->SetBinError(hardwareChannel + 1,
                                                                   h_projection->GetMeanError()); // Do we trust root on this?
        m_slotSigmaDeltaT[m_slotID - 1][m_calSetID]->SetBinContent(hardwareChannel + 1,
                                                                   h_projection->GetRMS()); // WARNING! What root calls "RMS" is actually a standard deviation
        m_slotSigmaDeltaT[m_slotID - 1][m_calSetID]->SetBinError(hardwareChannel + 1,
                                                                 h_projection->GetRMSError()); // WARNING! What root calls "RMS" is actually a standard deviation
 
        m_slotAverageDeltaTMap[m_slotID - 1][m_calSetID]->SetBinContent(colNum, rowNum, h_projection->GetMean());
        m_slotSigmaDeltaTMap[m_slotID - 1][m_calSetID]->SetBinContent(colNum, rowNum,
            h_projection->GetRMS());
 
        m_topAverageDeltaT[m_calSetID]->SetBinContent(globalChannel + 1, h_projection->GetMean());
        m_topSigmaDeltaT[m_calSetID]->SetBinContent(globalChannel + 1, h_projection->GetRMS());
      }
 
      // ---------
      // 3) Channel-by-channel average  occupancy
      // ---------
 
      // Checks that the histogram needed here is not corrupted before using it
      if (!m_calSetFile->Get(str(format("sampleOccup_ch%1%") % (iChannel)).c_str())) {
        B2WARNING("Error opening " << str(format("sampleOccup_ch%1%") % (iChannel)));
      } else {
        TH1F* h_sampleOccup = (TH1F*)m_calSetFile->Get(str(format("sampleOccup_ch%1%") % (iChannel)).c_str());
 
        // reads the occupancy histogram bin-by-by to look for (almost) empty samples
        int nEmpty = 0;
        for (int iSample = 1; iSample < m_numSamples + 1 ; iSample++) {
          if (h_sampleOccup->GetBinContent(iSample) < m_minCalPulses) nEmpty++;
        }
 
        m_slotSampleOccupancy[m_slotID - 1][m_calSetID]->SetBinContent(hardwareChannel + 1,  h_sampleOccup->Integral() / m_numSamples);
        m_slotEmptySamples[m_slotID - 1][m_calSetID]->SetBinContent(hardwareChannel + 1,  nEmpty);
 
        m_slotSampleOccupancyMap[m_slotID - 1][m_calSetID]->SetBinContent(colNum, rowNum,  h_sampleOccup->Integral() / m_numSamples);
        m_slotEmptySamplesMap[m_slotID - 1][m_calSetID]->SetBinContent(colNum, rowNum,  nEmpty);
 
        m_topSampleOccupancy[m_calSetID]->SetBinContent(globalChannel + 1, h_sampleOccup->Integral() / m_numSamples);
 
      }
 
 
 
    }
    return 1;
  }

associatePDFPeaks()

void associatePDFPeaks ( const TOP::PDFConstructor &  pdfConstructor )

private

Associate PDF peaks with photons using S-plot technique.

Parameters

pdfConstructor

reconstruction object for given track and hypothesis

Definition at line 192 of file TOPPDFDebuggerModule.cc.

  {
 
    const auto& signalPDFs = pdfConstructor.getSignalPDF();
    auto signalPhotons = pdfConstructor.getExpectedSignalPhotons();
    auto bkgPhotons = pdfConstructor.getExpectedBkgPhotons();
    auto deltaPhotons = pdfConstructor.getExpectedDeltaPhotons();
    int PDGCode = pdfConstructor.getHypothesis().getPDGCode();
 
    for (const auto& digit : m_digits) {
      if (digit.getModuleID() != pdfConstructor.getModuleID()) continue;
      if (digit.getHitQuality() != TOPDigit::c_Good) continue;
      int pixelID = digit.getPixelID();
      unsigned index = pixelID - 1;
      if (index >= signalPDFs.size()) continue;
      const auto& signalPDF = signalPDFs[index];
      const auto* tts = signalPDF.getTTS();
      const auto& pdfPeaks = signalPDF.getPDFPeaks();
      const auto& extraInfos = signalPDF.getPDFExtraInfo();
      if (extraInfos.size() != pdfPeaks.size()) {
        B2ERROR("associatePDFPeaks: sizes of PDFPeaks and ExtraInfo's differ");
        continue;
      }
 
      auto* associatedPDF = m_associatedPDFs.appendNew(PDGCode);
      digit.addRelationTo(associatedPDF);
 
      double bkgLevel = pdfConstructor.getBackgroundPDF()->getPDFValue(pixelID) * bkgPhotons;
      associatedPDF->setBackgroundWeight(bkgLevel);
      double deltaLevel = pdfConstructor.getDeltaRayPDF().getPDFValue(pixelID, digit.getTime()) * deltaPhotons;
      associatedPDF->setDeltaRayWeight(deltaLevel);
 
      float time = digit.getTime();
      float timeErr = digit.getTimeError();
 
      for (size_t k = 0; k < pdfPeaks.size(); k++) {
        const auto& pdfPeak = pdfPeaks[k];
        const auto& pdfExtra = extraInfos[k];
        TOPAssociatedPDF::PDFPeak peak;
        peak.position = pdfPeak.t0;
        peak.width = sqrt(pdfPeak.wid);
        peak.numPhotons = pdfPeak.nph * signalPhotons;
        float wt = 0;
        for (const auto& gaus : tts->getTTS()) {
          float sig2 = peak.width * peak.width + gaus.sigma * gaus.sigma + timeErr * timeErr;
          float x = pow(time - peak.position - gaus.position, 2) / sig2;
          if (x > 20) continue;
          wt += peak.numPhotons * gaus.fraction / sqrt(2 * M_PI * sig2) * exp(-x / 2);
        }
        if (wt > 0) {
          peak.fic = pdfPeak.fic;
          peak.e = pdfExtra.e;
          peak.sige = pdfExtra.sige;
          peak.nx = abs(pdfExtra.Nxm) + abs(pdfExtra.Nxb) + abs(pdfExtra.Nxe);
          peak.ny = abs(pdfExtra.Nym) + abs(pdfExtra.Nyb) + abs(pdfExtra.Nye);
          peak.nxm = abs(pdfExtra.Nxm);
          peak.nym = abs(pdfExtra.Nym);
          peak.nxe = abs(pdfExtra.Nxe);
          peak.nye = abs(pdfExtra.Nye);
          peak.xd = pdfExtra.xD;
          peak.yd = pdfExtra.yD;
          peak.type = pdfExtra.type;
          peak.kxe = pdfExtra.kxE;
          peak.kye = pdfExtra.kyE;
          peak.kze = pdfExtra.kzE;
          peak.kxd = pdfExtra.kxD;
          peak.kyd = pdfExtra.kyD;
          peak.kzd = pdfExtra.kzD;
          associatedPDF->appendPeak(peak, wt);
        }
      }
    }
 
  }

basicDebuggingPlots()

void basicDebuggingPlots

(

const TOPRawWaveform &

rawwave

)

Fills the debugging 1D histograms and hitmaps.

Parameters

rawwave

the raw waveform

Definition at line 81 of file TOPWaveformQualityPlotterModule.cc.

  {
    int scrodid = v.getScrodID();
    int asicid = v.getASICNumber();
    int channelid = v.getASICChannel();
    int carrierid = v.getCarrierNumber();
    m_scrod_id->Fill(scrodid);
    m_asic_ch->Fill(channelid);
    m_asic->Fill(asicid);
    m_carrier->Fill(carrierid);
    m_asic_win->Fill(v.getStorageWindow());
    m_entries->Fill(v.getWaveform().size());
    m_moduleID->Fill(v.getModuleID());
    m_pixelID->Fill(v.getPixelID());
 
    if (m_hitmap.find(scrodid) == m_hitmap.end()) {
      m_hitmap[scrodid] = new TH2F((string("scrod ") + to_string(scrodid) + string("Hitmap")).c_str(),
                                   (string("scrod ") + to_string(scrodid) + string("carrier vs. asic;asic;carrier")).c_str(), 4, 0, 4, 4, 0, 4);
    }
    m_hitmap[scrodid]->Fill(asicid, carrierid);
    const vector<short>& waveform = v.getWaveform();
    if (waveform.empty()) {
      return;
    }
    for (short adc : waveform) {
      m_samples->Fill(adc);
    }
  }

beginRun() [1/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from Module.

Definition at line 195 of file TOPBackgroundModule.cc.

  {
    // Print run number
    B2INFO("TOPBackground: Processing:");
 
  }

beginRun() [2/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Reimplemented from Module.

Definition at line 202 of file TOPBunchFinderModule.cc.

  {
    StoreObjPtr<EventMetaData> evtMetaData;
 
    if (not m_commonT0.isValid()) {
      B2FATAL("Common T0 calibration payload requested but not available for run "
              << evtMetaData->getRun()
              << " of experiment " << evtMetaData->getExperiment());
    }
 
    if (m_HLTmode) return;
 
    if (m_useTimeSeed and not m_eventT0Offset.isValid()) {
      B2WARNING("EventT0Offset not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment()
                << ": seeding with SVD or CDC eventT0 will not be done.");
    }
    if (m_useFillPattern) {
      if (not m_bunchStructure->isSet()) {
        B2WARNING("BunchStructure not available for run "
                  << evtMetaData->getRun()
                  << " of experiment " << evtMetaData->getExperiment()
                  << ": fill pattern will not be used.");
      }
      if (not m_fillPatternOffset.isValid()) {
        B2WARNING("FillPatternOffset not available for run "
                  << evtMetaData->getRun()
                  << " of experiment " << evtMetaData->getExperiment()
                  << ": fill pattern will not be used.");
      }
    }
 
  }

beginRun() [3/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from Module.

Definition at line 54 of file TOPChannelMaskerModule.cc.

  {
 
    if (not m_channelMask.isValid()) {
      B2FATAL("channel mask not available");
    }
    if (not m_channelT0.isValid()) {
      B2FATAL("channel T0 calibration not available");
    }
    if (not m_timebase.isValid()) {
      B2FATAL("timebase calibration not available");
    }
 
  }

beginRun() [4/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Reimplemented from Module.

Definition at line 63 of file TOPChannelT0MCModule.cc.

  {
  }

beginRun() [5/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Reimplemented from Module.

Definition at line 142 of file TOPDigitizerModule.cc.

  {
    StoreObjPtr<EventMetaData> evtMetaData;
 
    // check availability of mappers
    const auto& channelMapper = TOPGeometryPar::Instance()->getChannelMapper();
    if (not channelMapper.isValid()) {
      B2FATAL("No valid channel mapper found for run "
              << evtMetaData->getRun()
              << " of experiment " << evtMetaData->getExperiment());
    }
    const auto& frontEndMapper = TOPGeometryPar::Instance()->getFrontEndMapper();
    if (not frontEndMapper.isValid()) {
      B2FATAL("No valid front-end mapper found for run "
              << evtMetaData->getRun()
              << " of experiment " << evtMetaData->getExperiment());
    }
 
    // check availability of constants in database
    if (m_useDatabase) {
      if (not m_timebases.isValid()) {
        B2FATAL("Sample time calibration constants requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
      if (not m_channelT0.isValid()) {
        B2FATAL("Channel T0 calibration constants requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
      if (not m_asicShift.isValid()) {
        B2FATAL("ASIC shifts calibration requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
      if (not m_moduleT0.isValid()) {
        B2FATAL("Module T0 calibration constants requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
      if (not m_commonT0.isValid()) {
        B2FATAL("Common T0 calibration constants requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
      if (not m_pulseHeights.isValid()) {
        B2FATAL("Pulse height calibration constants requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
      if (not m_thresholds.isValid()) {
        B2FATAL("Channel thresholds requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
      if (not m_noises.isValid()) {
        B2FATAL("Channel noise levels requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
      if (m_timeWalk.isValid()) {
        TimeDigitizer::setTimeWalk(&m_timeWalk);
      } else {
        TimeDigitizer::setTimeWalk(0);
        // B2FATAL("Time-walk parameters requested but not available for run "
        B2WARNING("Time-walk parameters not available for run "
                  << evtMetaData->getRun()
                  << " of experiment " << evtMetaData->getExperiment());
      }
    } else if (m_useSampleTimeCalibration) {
      if (not m_timebases.isValid()) {
        B2FATAL("Sample time calibration constants requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
    }
 
    // check availability of front-end settings
    if (not m_feSetting.isValid()) {
      B2FATAL("Front-end settings are not available for run "
              << evtMetaData->getRun()
              << " of experiment " << evtMetaData->getExperiment());
    }
 
    // pass a parameter to TimeDigitizer
    TimeDigitizer::setReadoutWindows(m_feSetting->getReadoutWindows());
    if ((evtMetaData->getExperiment() > 0 and evtMetaData->getExperiment() < 5) or
        evtMetaData->getExperiment() == 1002) {
      TimeDigitizer::maskSamples(true); // phase-2: mask samples at window boundaries
    } else {
      TimeDigitizer::maskSamples(false); // phase-3: no masking
    }
 
  }

beginRun() [6/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Reimplemented from Module.

Definition at line 86 of file TOPTriggerDigitizerModule.cc.

  {
  }

beginRun() [7/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from Module.

Definition at line 148 of file TOPDoublePulseGeneratorModule.cc.

  {
    StoreObjPtr<EventMetaData> evtMetaData;
    if (m_useDatabase) {
      if (!(*m_timebase).isValid()) {
        B2FATAL("Sample time calibration requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
    }
 
  }

beginRun() [8/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from HistoModule.

Definition at line 274 of file TOPDQMModule.cc.

  {
    m_BoolEvtMonitor->Reset();
    m_window_vs_slot->Reset();
    m_eventT0->Reset();
    m_bunchOffset->Reset();
    m_time->Reset();
    m_timeBG->Reset();
    m_signalHits->Reset();
    m_backgroundHits->Reset();
    m_trackHits->Reset();
    m_goodTDCAll->Reset();
    m_badTDCAll->Reset();
    m_goodHitsPerEventAll->Reset();
    m_badHitsPerEventAll->Reset();
    m_TOPOccAfterInjLER->Reset();
    m_TOPOccAfterInjHER->Reset();
    m_TOPEOccAfterInjLER->Reset();
    m_TOPEOccAfterInjHER->Reset();
 
    for (int i = 0; i < m_numModules; i++) {
      m_window_vs_asic[i]->Reset();
      m_goodHitsXY[i]->Reset();
      m_badHitsXY[i]->Reset();
      m_goodHitsAsics[i]->Reset();
      m_badHitsAsics[i]->Reset();
      m_goodTDC[i]->Reset();
      m_badTDC[i]->Reset();
      m_goodTiming[i]->Reset();
      m_goodTimingBG[i]->Reset();
      m_goodChannelHits[i]->Reset();
      m_badChannelHits[i]->Reset();
      m_pulseHeights[i]->Reset();
    }
  }

beginRun() [9/22]

void beginRun ( void  )

overridevirtual

The main processes, fitting charge distribution and calculating gain/efficiency, are done in this function.

Reimplemented from HistoModule.

Definition at line 160 of file TOPGainEfficiencyCalculatorModule.cc.

  {
  }

beginRun() [10/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from HistoModule.

Definition at line 150 of file TOPLaserHitSelectorModule.cc.

  {
  }

beginRun() [11/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from HistoModule.

Definition at line 159 of file TOPInterimFENtupleModule.cc.

  {
  }

beginRun() [12/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from Module.

Definition at line 81 of file TOPLaserCalibratorModule.cc.

  {
  }

beginRun() [13/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from Module.

Definition at line 88 of file TOPMCTrackMakerModule.cc.

  {
  }

beginRun() [14/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from Module.

Definition at line 160 of file TOPModuleT0CalibratorModule.cc.

  {
    if (m_moduleT0.hasChanged()) {
      StoreObjPtr<EventMetaData> evtMetaData;
      B2WARNING("ModuleT0 payload has changed. Calibration results may not be correct."
                << LogVar("run", evtMetaData->getRun()));
    }
  }

beginRun() [15/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from Module.

Definition at line 127 of file TOPNtupleModule.cc.

  {
  }

beginRun() [16/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from Module.

Definition at line 99 of file TOPPackerModule.cc.

  {
  }

beginRun() [17/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from Module.

Definition at line 132 of file TOPRawDigitConverterModule.cc.

  {
 
    StoreObjPtr<EventMetaData> evtMetaData;
 
    // check if calibrations are available when needed - if not, terminate
 
    if (m_useSampleTimeCalibration) {
      if (not m_timebase.isValid()) {
        B2FATAL("Sample time calibration requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
    }
    if (m_useChannelT0Calibration) {
      if (not m_channelT0.isValid()) {
        B2FATAL("Channel T0 calibration requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
    }
    if (m_useAsicShiftCalibration) {
      if (not m_asicShift.isValid()) {
        B2FATAL("ASIC shifts calibration requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
    }
    if (m_useModuleT0Calibration) {
      if (not m_moduleT0.isValid()) {
        B2FATAL("Module T0 calibration requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
    }
    if (m_useCommonT0Calibration) {
      if (not m_commonT0.isValid()) {
        B2FATAL("Common T0 calibration requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
    }
    if (not m_timeWalk.isValid()) {
      // B2FATAL("Time-walk calibration is not available for run "
      B2WARNING("Time-walk calibration is not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
    }
    if (m_pedestalRMS > 0 and not m_noises.isValid()) {
      B2FATAL("Channel noise levels are not available for run "
              << evtMetaData->getRun()
              << " of experiment " << evtMetaData->getExperiment());
    }
 
    if (not m_feSetting.isValid()) {
      B2FATAL("Front-end settings are not available for run "
              << evtMetaData->getRun()
              << " of experiment " << evtMetaData->getExperiment());
    }
 
  }

beginRun() [18/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Reimplemented from HistoModule.

Definition at line 341 of file TOPTBCComparatorModule.cc.

  {
    return;
  }

beginRun() [19/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from Module.

Definition at line 143 of file TOPTimeBaseCalibratorModule.cc.

  {
  }

beginRun() [20/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from Module.

Definition at line 85 of file TOPTimeRecalibratorModule.cc.

  {
    StoreObjPtr<EventMetaData> evtMetaData;
 
    // check if calibrations are available when needed - if not, terminate
 
    if (m_useSampleTimeCalibration) {
      if (not m_timebase.isValid()) {
        B2FATAL("Sample time calibration requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
    }
    if (m_useChannelT0Calibration) {
      if (not m_channelT0.isValid()) {
        B2FATAL("Channel T0 calibration requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
    }
    if (m_useAsicShiftCalibration) {
      if (not m_asicShift.isValid()) {
        B2FATAL("ASIC shifts calibration requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
    }
    if (m_useModuleT0Calibration) {
      if (not m_moduleT0.isValid()) {
        B2FATAL("Module T0 calibration requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
    }
    if (m_useCommonT0Calibration) {
      if (not m_commonT0.isValid()) {
        B2FATAL("Common T0 calibration requested but not available for run "
                << evtMetaData->getRun()
                << " of experiment " << evtMetaData->getExperiment());
      }
    }
    if (m_useTimeWalkCalibration) {
      if (not m_timeWalk.isValid()) {
        // B2FATAL("Time-walk calibration requested but not available for run "
        B2WARNING("Time-walk calibration is not available for run "
                  << evtMetaData->getRun()
                  << " of experiment " << evtMetaData->getExperiment());
      }
    }
 
    if (not m_feSetting.isValid()) {
      B2FATAL("Front-end settings are not available for run "
              << evtMetaData->getRun()
              << " of experiment " << evtMetaData->getExperiment());
    }
 
  }

beginRun() [21/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from Module.

Definition at line 113 of file TOPUnpackerModule.cc.

  {
    m_channelStatistics.clear();
  }

beginRun() [22/22]

void beginRun ( void  )

overridevirtual

Called when entering a new run.

Set run dependent things like run header parameters, alignment, etc.

Reimplemented from Module.

Definition at line 78 of file TOPWaveformFeatureExtractorModule.cc.

  {
  }

calculateHistoRatio() [1/2]

TH1F * calculateHistoRatio	(	TH1F *	hRatio,
		TH1F *	hNum,
		TH1F *	hDen
	)

Utility function to take the ratio of two histograms using TH1::Divide(), without overwriting the output name and title initialized in defineHisto().

Definition at line 591 of file TOPTBCComparatorModule.cc.

  {
    // Saves the name and titple of the output histogram, as defined in defineHisto
    const char* name = hRatio->GetName();
    const char* title = hRatio->GetTitle();
 
    const char* xAxisTitle = hRatio->GetXaxis()->GetTitle();
    const char* yAxisTitle = hRatio->GetYaxis()->GetTitle();
 
    // clone the numerator histogram into the output one
    hRatio = (TH1F*)hNum->Clone();
 
 
    // makes the ratio
    hRatio->Divide(hDen);
 
    //ri-sets name, title and axis labels
    hRatio->SetName(name);
    hRatio->SetTitle(title);
    hRatio->GetXaxis()->SetTitle(xAxisTitle);
    hRatio->GetYaxis()->SetTitle(yAxisTitle);
    return hRatio;
  }

calculateHistoRatio() [2/2]

TH2F * calculateHistoRatio	(	TH2F *	hRatio,
		TH2F *	hNum,
		TH2F *	hDen
	)

Utility function to take the ratio of two histograms using TH2::Divide(), without overwriting the output name and title initialized in defineHisto().

Definition at line 615 of file TOPTBCComparatorModule.cc.

  {
    // Saves the name and titple of the output histogram, as defined in defineHisto
    const char* name = hRatio->GetName();
    const char* title = hRatio->GetTitle();
 
    const char* xAxisTitle = hRatio->GetXaxis()->GetTitle();
    const char* yAxisTitle = hRatio->GetYaxis()->GetTitle();
 
    // clone the numerator histogram into the output one
    hRatio = (TH2F*)hNum->Clone();
 
 
    // makes the ratio
    hRatio->Divide(hDen);
 
    //ri-sets name, title and axis labels
    hRatio->SetName(name);
    hRatio->SetTitle(title);
    hRatio->GetXaxis()->SetTitle(xAxisTitle);
    hRatio->GetYaxis()->SetTitle(yAxisTitle);
    return hRatio;
  }

calibrateChannel()

bool calibrateChannel ( std::vector< TwoTimes > &  ntuple, unsigned  scrodID, unsigned  scrodChannel, TH1F &  Hchi2, TH1F &  Hndf, TH1F &  HDeltaT  )

private

calibrate single channel

Parameters

ntuple	ntuple data
scrodID	SCROD ID
scrodChannel	channel number within SCROD (0 - 127)
Hchi2	histogram to store normalized chi^2
Hndf	histogram to store degrees of freedom
HDeltaT	histogram to store fittet double pulse delay

Returns

true on success

Definition at line 311 of file TOPTimeBaseCalibratorModule.cc.

  {
 
    // determine outlayer removal cuts
 
    string name = "timeDiff_ch" + to_string(chan);
    string forWhat = "scrod " + to_string(scrodID) + " channel " + to_string(chan);
    string title = "Cal pulse time difference vs. sample for " + forWhat;
    TProfile prof(name.c_str(), title.c_str(), c_TimeAxisSize, 0, c_TimeAxisSize,
                  m_minTimeDiff, m_maxTimeDiff, "S");
    prof.SetXTitle("sample number");
    prof.SetYTitle("time difference [samples]");
 
    name = "sampleOccup_ch" + to_string(chan);
    title = "Occupancy for " + forWhat;
    TH1F hist(name.c_str(), title.c_str(), c_TimeAxisSize, 0, c_TimeAxisSize);
    hist.SetXTitle("sample number");
    hist.SetYTitle("entries per sample");
 
    vector<double> profMeans(c_TimeAxisSize, (m_maxTimeDiff + m_minTimeDiff) / 2);
    double sigma = (m_maxTimeDiff - m_minTimeDiff) / 6;
 
    for (int iter = 0; iter < 5; iter++) {
      prof.Reset();
      double x = 0;
      double x2 = 0;
      int n = 0;
      for (auto& twoTimes : ntuple) {
        int sample = int(twoTimes.t1) % c_TimeAxisSize;
        double diff = twoTimes.t2 - twoTimes.t1;
        double Ddiff = diff - profMeans[sample];
        if (fabs(Ddiff) < 3 * sigma) {
          prof.Fill(sample, diff);
          hist.Fill(sample);
          x += Ddiff;
          x2 += Ddiff * Ddiff;
          n++;
          twoTimes.good = true;
        } else {
          twoTimes.good = false;
        }
      }
      for (int i = 0; i < c_TimeAxisSize; i++) {
        profMeans[i] = prof.GetBinContent(i + 1);
      }
      if (n == 0) return false;
      x2 /= n;
      x /= n;
      sigma = sqrt(x2 - x * x);
    }
    prof.Write();
    hist.Write();
 
    // calculate average time difference
 
    double meanTimeDifference = 0;
    for (auto& x : profMeans) meanTimeDifference += x;
    meanTimeDifference /= profMeans.size();
    meanTimeDifference -= int(meanTimeDifference / static_cast<double>(c_TimeAxisSize)) * c_TimeAxisSize;
 
    // perform the fit
 
    switch (m_method) {
      case 0:
        B2INFO("... channel " << chan << ": "
               << ntuple.size() << " double cal pulses)");
        return false;
      case 1:
        return matrixInversion(ntuple, scrodID, chan, meanTimeDifference,
                               Hchi2, Hndf, HDeltaT);
      case 2:
        return iterativeTBC(ntuple, scrodID, chan, meanTimeDifference,
                            Hchi2, Hndf, HDeltaT);
      case 3:
        B2ERROR("Singuler value decomposition not implemented yet");
        return false;
      default:
        B2ERROR("Unknown method " << m_method);
        return false;
    }
 
  }

Chisq()

double Chisq ( const std::vector< TwoTimes > &  ntuple, const std::vector< double > &  xxval  )

private

Return the chisqure of one set of TBC constants (xval) in iTBC calculaton.

Parameters

ntuple	ntuple data
xxval	TBC constants of 256 samples, and xxval[0]=0, xxval[256]=2*FTSW

Definition at line 669 of file TOPTimeBaseCalibratorModule.cc.

  {
    double sum1 = 0.0;
    double sum2 = 0.0; //sum od dt and dt**2
 
    m_good = 0;
 
    for (const auto& twoTimes : ntuple) {
      if (!twoTimes.good) continue;
 
      std::vector<double> m(c_TimeAxisSize, 0.0);
 
      int i1 = int(twoTimes.t1);
      double fr = twoTimes.t1 - i1;
      double samp0 = i1 % 256;
      double ctdc1 = xxval[samp0] + fr * (xxval[samp0 + 1] - xxval[samp0]);
      int i2 = int(twoTimes.t2);
      fr = twoTimes.t2 - i2;
      double samp1 = i2 % 256;
      double ctdc2 = xxval[samp1] + fr * (xxval[samp1 + 1] - xxval[samp1]);
      double cdt = 0.0;
      if (samp1 > samp0) cdt = ctdc2 - ctdc1;
      else            cdt = ctdc2 - ctdc1 + m_syncTimeBase * 2;
 
      if (cdt < m_dt_max && cdt > m_dt_min) {
        sum1 += cdt;
        sum2 += cdt * cdt;
        m_good++;
      }
    }
 
    double chi2 = -1.0;
 
    if (m_good > 10) {
      double mean = sum1 / m_good;
      chi2 = (sum2 - m_good * mean * mean) / m_good / m_sigm2_exp;
    }
    return chi2;
  }

closeRun()

void closeRun ( )

finalprivatevirtual

Replacement for endRun().

Do anything you would normally do in endRun here.

Reimplemented from CalibrationCollectorModule.

Definition at line 288 of file TOPValidationCollectorModule.cc.

  {
 
    // module T0 pulls
 
    for (int module = 0; module < c_numModules; module++) {
      std::vector<double> pos, err;
      for (int set = 0; set < c_numSets; set++) {
        const auto& minimum = m_finders[set][module].getMinimum();
        if (minimum.valid) {
          pos.push_back(minimum.position);
          err.push_back(minimum.error);
        }
      }
      auto h_pulls = getObjectPtr<TH1F>("moduleT0_pulls");
      for (unsigned i = 0; i < pos.size(); i++) {
        for (unsigned j = i + 1; j < pos.size(); j++) {
          double pull = (pos[i] - pos[j]) / sqrt(err[i] * err[i] + err[j] * err[j]);
          h_pulls->Fill(pull);
        }
      }
    }
 
    // module T0 residuals
 
    for (int module = 0; module < c_numModules; module++) {
      auto& finder = m_finders[0][module];
      for (int set = 1; set < c_numSets; set++) {
        finder.add(m_finders[set][module]);
      }
      const auto& minimum = finder.getMinimum();
      if (minimum.valid) {
        m_treeEntry.moduleT0[module] = minimum.position;
        m_treeEntry.moduleT0Err[module] = minimum.error;
      }
    }
 
    // common T0 residual
 
    auto& finder = m_finders[0][0];
    for (int module = 1; module < c_numModules; module++) {
      finder.add(m_finders[0][module]);
    }
    const auto& minimum = finder.getMinimum();
    if (minimum.valid) {
      m_treeEntry.commonT0 = minimum.position;
      m_treeEntry.commonT0Err = minimum.error;
    }
 
    // fill the tree
 
    auto tree = getObjectPtr<TTree>("tree");
    tree->Fill();
  }

collect() [1/11]

void collect ( )

finalprivatevirtual

Replacement for event().

Fill your calibration data objects here

Reimplemented from CalibrationCollectorModule.

Definition at line 216 of file TOPAlignmentCollectorModule.cc.

  {
    // bunch must be reconstructed
 
    if (not m_recBunch.isValid()) return;
    if (not m_recBunch->isReconstructed()) return;
 
    // track-by-track iterations
 
    for (const auto& track : m_tracks) {
 
      // construct TOPTrack from mdst track
      TOPTrack trk(track);
      if (not trk.isValid()) continue;
 
      // skip if track not hitting target module
      if (trk.getModuleID() != m_targetMid) continue;
 
      // track selection
      if (not m_selector.isSelected(trk)) continue;
 
      // generate sub-sample number
      int sub = gRandom->Integer(c_numSets);
      auto& align = m_align[sub];
      auto& countFails = m_countFails[sub];
      const auto& name = m_treeNames[sub];
      auto h1 = getObjectPtr<TH2F>("tracks_per_slot");
      h1->Fill(trk.getModuleID(), sub);
 
      // do an iteration
      int err = align.iterate(trk, m_selector.getChargedStable());
      m_iter++;
 
      // check number of consecutive failures, and in case reset
      if (err == 0) {
        countFails = 0;
      } else if (countFails <= m_maxFails) {
        countFails++;
      } else {
        B2INFO("Reached maximum allowed number of failed iterations. "
               "Resetting TOPalign object of set = " << sub << " at iter = " << m_iter);
        align.reset();
        countFails = 0;
      }
 
      // get new parameter values and estimated errors
      m_vAlignPars = align.getParameters();
      m_vAlignParsErr = align.getErrors();
      m_ntrk = align.getNumUsedTracks();
      m_errorCode = err;
      m_valid = align.isValid();
      m_numPhot = align.getNumOfPhotons();
 
      // set other ntuple variables
      const auto& localPosition = m_selector.getLocalPosition();
      m_x = localPosition.X();
      m_y = localPosition.Y();
      m_z = localPosition.Z();
      const auto& localMomentum = m_selector.getLocalMomentum();
      m_p = localMomentum.R();
      m_theta = localMomentum.Theta();
      m_phi = localMomentum.Phi();
      const auto& pocaPosition = m_selector.getPOCAPosition();
      m_pocaR = pocaPosition.Rho();
      m_pocaZ = pocaPosition.Z();
      m_pocaX = pocaPosition.X();
      m_pocaY = pocaPosition.Y();
      m_cmsE = m_selector.getCMSEnergy();
      m_charge = trk.getCharge();
      m_PDG = trk.getPDGCode();
 
      // fill output tree
      auto alignTree = getObjectPtr<TTree>(name);
      alignTree->Fill();
 
      // fill control histograms
      std::string slotName = "_s" + to_string(m_targetMid);
      auto h2 = getObjectPtr<TH1F>("local_z" + slotName);
      h2->Fill(m_z);
      auto h3 = getObjectPtr<TH2F>("cth_vs_p" + slotName);
      h3->Fill(m_p, cos(m_theta));
      auto h4 = getObjectPtr<TH2F>("poca_xy" + slotName);
      h4->Fill(m_pocaX, m_pocaY);
      auto h5 = getObjectPtr<TH1F>("poca_z" + slotName);
      h5->Fill(m_pocaZ);
      auto h6 = getObjectPtr<TH1F>("Ecms" + slotName);
      h6->Fill(m_cmsE);
      auto h7 = getObjectPtr<TH1F>("charge" + slotName);
      h7->Fill(m_charge);
      auto h8 = getObjectPtr<TH2F>("timeHits" + slotName);
      for (const auto& digit : m_digits) {
        if (digit.getHitQuality() != TOPDigit::c_Good) continue;
        if (digit.getModuleID() != m_targetMid) continue;
        h8->Fill(digit.getChannel(), digit.getTime());
      }
      auto h9 = getObjectPtr<TH1F>("numPhot" + slotName);
      h9->Fill(m_numPhot);
 
    } // tracks
 
  }

collect() [2/11]

void collect ( )

finalprivatevirtual

Replacement for event().

Fill your calibration data objects here.

Reimplemented from CalibrationCollectorModule.

Definition at line 91 of file TOPAsicShiftsBS13dCollectorModule.cc.

  {
 
    if (m_requireRecBunch) {
      if (not m_recBunch.isValid()) return;
      if (not m_recBunch->isReconstructed()) return;
    }
 
    auto time_vs_BS = getObjectPtr<TH2F>("time_vs_BS");
    auto timeReference = getObjectPtr<TH1F>("time_reference");
    std::vector<TH1F*> timeCarriers;
    for (unsigned i = 0; i < 4; i++) {
      string name = "time_carr_" + to_string(i);
      auto h = getObjectPtr<TH1F>(name);
      timeCarriers.push_back(h);
    }
 
    for (const auto& digit : m_topDigits) {
      if (digit.getModuleID() != 13) continue;
      if (digit.getHitQuality() != TOPDigit::c_Good) continue;
      double time = digit.getTime() - m_timeOffset;
      time_vs_BS->Fill(digit.getChannel(), time);
      if (digit.getBoardstackNumber() < 3) {
        timeReference->Fill(time);
      } else {
        auto c = digit.getCarrierNumber();
        timeCarriers[c]->Fill(time);
      }
    }
 
  }

collect() [3/11]

void collect ( )

finalprivatevirtual

Replacement for event().

Fill your calibration data objects here

Reimplemented from CalibrationCollectorModule.

Definition at line 70 of file TOPChannelMaskCollectorModule.cc.

  {
 
    std::vector<TH1F*> slots;
    for (const auto& name : m_names) {
      auto h = getObjectPtr<TH1F>(name);
      slots.push_back(h);
    }
 
    std::vector<TH2F*> asics;
    for (const auto& name : m_asicNames) {
      auto h = getObjectPtr<TH2F>(name);
      asics.push_back(h);
    }
 
    int NGood = 0;
    for (const auto& digit : m_digits) {
      if (digit.getHitQuality() == TOPDigit::c_Junk) continue;
      NGood++;
      unsigned m = digit.getModuleID() - 1;
      if (m < slots.size()) slots[m]->Fill(digit.getChannel());
      if (m < asics.size()) asics[m]->Fill(digit.getChannel() / 8, digit.getRawTime() / 64 + 220);
    }
 
    auto h = getObjectPtr<TH1F>("nhits");
    h->Fill(NGood);
 
  }

collect() [4/11]

void collect ( )

finalprivatevirtual

Replacement for event().

Fill your calibration data objects here

Reimplemented from CalibrationCollectorModule.

Definition at line 68 of file TOPCommonT0BFCollectorModule.cc.

  {
 
    if (not m_recBunch.isValid()) return;
    if (not m_recBunch->isReconstructed()) return;
    if (m_recBunch->getNumTracks() != 2) return;
 
    auto h1a = getObjectPtr<TH1F>("offset_a");
    auto h1b = getObjectPtr<TH1F>("offset_b");
    auto offset = m_recBunch->getCurrentOffset();
    if (m_commonT0->isCalibrated()) offset += m_commonT0->getT0();
 
    // wrap-around into [-1/2, 1/2] of bunch cycle
    auto a = offset - round(offset / m_bunchTimeSep) * m_bunchTimeSep;
    h1a->Fill(a);
 
    // wrap-around into [0, 1] of bunch cycle
    auto b = offset - round(offset / m_bunchTimeSep - 0.5) * m_bunchTimeSep;
    h1b->Fill(b);
 
  }

collect() [5/11]

void collect ( )

finalprivatevirtual

Replacement for event().

Fill your calibration data objects here

Reimplemented from CalibrationCollectorModule.

Definition at line 148 of file TOPCommonT0LLCollectorModule.cc.

  {
    // bunch must be reconstructed
 
    if (not m_recBunch.isValid()) return;
    if (not m_recBunch->isReconstructed()) return;
 
    TOPRecoManager::setDefaultTimeWindow();
    double timeMin = TOPRecoManager::getMinTime();
    double timeMax = TOPRecoManager::getMaxTime();
 
    // correct-back digits for common T0
 
    double T0 = 0;
    if (m_commonT0->isCalibrated()) T0 = m_commonT0->getT0();
    for (auto& digit : m_digits) {
      if (digit.isCommonT0Calibrated()) digit.subtractT0(-T0);
      if (digit.hasStatus(TOPDigit::c_BunchOffsetSubtracted)) digit.subtractT0(-m_recBunch->getAverageOffset());
    }
 
    // loop over reconstructed tracks, make a selection and accumulate log likelihoods
 
    int ntra = 0;
    for (const auto& track : m_tracks) {
 
      // track selection
      TOPTrack trk(track);
      if (not trk.isValid()) continue;
 
      if (not m_selector.isSelected(trk)) continue;
 
      // construct PDF
      PDFConstructor pdfConstructor(trk, m_selector.getChargedStable(), m_PDFOption);
      if (not pdfConstructor.isValid()) continue;
 
      // minimization procedure: accumulate
      int sub = gRandom->Integer(c_numSets); // generate sub-sample number
      auto h = getObjectPtr<TH1D>(m_names[sub]);
      for (int ibin = 0; ibin < h->GetNbinsX(); ibin++) {
        double t0 = h->GetBinCenter(ibin + 1);
        double chi = h->GetBinContent(ibin + 1);
        chi += -2 * pdfConstructor.getLogL(t0, m_sigmaSmear).logL;
        h->SetBinContent(ibin + 1, chi);
      }
      auto h1 = getObjectPtr<TH1F>("tracks_per_set");
      h1->Fill(sub);
 
      // fill histograms of hits
      auto h2 = getObjectPtr<TH1F>("numHits");
      auto h3 = getObjectPtr<TH2F>("timeHits");
      for (const auto& digit : m_digits) {
        if (digit.getHitQuality() != TOPDigit::c_Good) continue;
        if (digit.getModuleID() != trk.getModuleID()) continue;
        if (digit.getTime() < timeMin) continue;
        if (digit.getTime() > timeMax) continue;
        h2->Fill(digit.getModuleID());
        int bs = digit.getBoardstackNumber();
        h3->Fill((digit.getModuleID() * 4 + bs - 1.5) / 4.0, digit.getTime());
      }
      ntra++;
    }
 
    // fill just another control histogram
 
    if (ntra > 0) {
      auto h4 = getObjectPtr<TH1F>("offset");
      h4->Fill(m_recBunch->getCurrentOffset());
    }
 
  }

collect() [6/11]

void collect ( )

finalprivatevirtual

Replacement for event().

Fill your calibration data objects here

Reimplemented from CalibrationCollectorModule.

Definition at line 78 of file TOPModuleT0DeltaTCollectorModule.cc.

  {
 
    if (m_timeZeros.getEntries() != 2) return;
 
    const auto* timeZero1 = m_timeZeros[0];
    const auto* timeZero2 = m_timeZeros[1];
    if (timeZero1->getModuleID() > timeZero2->getModuleID()) {
      timeZero1 = m_timeZeros[1];
      timeZero2 = m_timeZeros[0];
    }
 
    int slot1 = timeZero1->getModuleID();
    int slot2 = timeZero2->getModuleID();
    if (slot1 > 9 or slot2 - slot1 < 7 or slot2 - slot1 > 9) return;
    string name = "deltaT0_" + to_string(slot1) + "-" + to_string(slot2);
    auto h = getObjectPtr<TH1F>(name);
    if (not h) return;
 
    double t1 = timeZero1->getTime();
    if (m_moduleT0->isCalibrated(slot1)) t1 += m_moduleT0->getT0(slot1);
    double t2 = timeZero2->getTime();
    if (m_moduleT0->isCalibrated(slot2)) t2 += m_moduleT0->getT0(slot2);
    h->Fill(t1 - t2);
 
    auto slotPairs = getObjectPtr<TH2F>("slots");
    slotPairs->Fill(slot1, slot2);
  }

collect() [7/11]

void collect ( )

finalprivatevirtual

Replacement for event().

Fill your calibration data objects here

Reimplemented from CalibrationCollectorModule.

Definition at line 150 of file TOPModuleT0LLCollectorModule.cc.

  {
    // bunch must be reconstructed
 
    if (not m_recBunch.isValid()) return;
    if (not m_recBunch->isReconstructed()) return;
 
    TOPRecoManager::setDefaultTimeWindow();
    double timeMin = TOPRecoManager::getMinTime();
    double timeMax = TOPRecoManager::getMaxTime();
 
    // correct-back digits for module T0
 
    for (auto& digit : m_digits) {
      int slot = digit.getModuleID();
      if (digit.isModuleT0Calibrated()) digit.subtractT0(-m_moduleT0->getT0(slot));
      if (digit.hasStatus(TOPDigit::c_BunchOffsetSubtracted)) digit.subtractT0(-m_recBunch->getAverageOffset());
    }
 
    // loop over reconstructed tracks, make a selection and accumulate log likelihoods
 
    int ntra = 0;
    for (const auto& track : m_tracks) {
 
      // track selection
      TOPTrack trk(track);
      if (not trk.isValid()) continue;
 
      if (not m_selector.isSelected(trk)) continue;
 
      // construct PDF
      PDFConstructor pdfConstructor(trk, m_selector.getChargedStable(), m_PDFOption);
      if (not pdfConstructor.isValid()) continue;
 
      // minimization procedure: accumulate
      int sub = gRandom->Integer(c_numSets); // generate sub-sample number
      unsigned module = trk.getModuleID() - 1;
      if (module >= m_names[sub].size()) continue;
      auto h = getObjectPtr<TH1D>(m_names[sub][module]);
      for (int ibin = 0; ibin < h->GetNbinsX(); ibin++) {
        double t0 = h->GetBinCenter(ibin + 1);
        double chi = h->GetBinContent(ibin + 1);
        chi += -2 * pdfConstructor.getLogL(t0, m_sigmaSmear).logL;
        h->SetBinContent(ibin + 1, chi);
      }
      auto h1 = getObjectPtr<TH2F>("tracks_per_slot");
      h1->Fill(trk.getModuleID(), sub);
 
      // fill histograms of hits
      auto h2 = getObjectPtr<TH1F>("numHits");
      auto h3 = getObjectPtr<TH2F>("timeHits");
      for (const auto& digit : m_digits) {
        if (digit.getHitQuality() != TOPDigit::c_Good) continue;
        if (digit.getModuleID() != trk.getModuleID()) continue;
        if (digit.getTime() < timeMin) continue;
        if (digit.getTime() > timeMax) continue;
        h2->Fill(digit.getModuleID());
        int bs = digit.getBoardstackNumber();
        h3->Fill((digit.getModuleID() * 4 + bs - 1.5) / 4.0, digit.getTime());
      }
      ntra++;
    }
 
    // fill just another control histogram
 
    if (ntra > 0) {
      auto h4 = getObjectPtr<TH1F>("offset");
      h4->Fill(m_recBunch->getCurrentOffset());
    }
 
  }

collect() [8/11]

void collect ( )

finalprivatevirtual

Replacement for event().

Fill your calibration data objects here

Reimplemented from CalibrationCollectorModule.

Definition at line 61 of file TOPOffsetCollectorModule.cc.

  {
    if (m_firstEvent) {
      m_firstEvent = false;
      if (m_bunchStructure->isSet()) {
        auto h = getObjectPtr<TH1F>("fillPattern");
        int RFBuckets = m_bunchStructure->getRFBucketsPerRevolution();
        for (int i = 0; i < RFBuckets; i++) {
          if (m_bunchStructure->getBucket(i)) h->SetBinContent(i + 1, 1);
        }
      }
    }
 
    if (not m_recBunch->isReconstructed()) return;
 
    for (const auto& x : m_names) {
      const auto& detector = x.first;
      if (m_eventT0->hasTemporaryEventT0(detector)) {
        auto eventT0s = m_eventT0->getTemporaryEventT0s(detector);
        if (eventT0s.empty()) continue;
        if (detector == Const::CDC and eventT0s.back().algorithm != "chi2") continue;
        double t0 = eventT0s.back().eventT0;
        auto h = getObjectPtr<TH1F>(x.second);
        h->Fill(t0 - m_recBunch->getTime());
      }
    }
 
    auto h = getObjectPtr<TH1F>("recBuckets");
    h->Fill(m_recBunch->getBucketNumber(0, m_bunchStructure->getRFBucketsPerRevolution()));
  }

collect() [9/11]

void collect ( )

finalprivatevirtual

Replacement for event().

Fill your calibration data objects here

Reimplemented from CalibrationCollectorModule.

Definition at line 171 of file TOPPhotonYieldsCollectorModule.cc.

  {
    // bunch must be reconstructed
 
    if (not m_recBunch->isReconstructed()) return;
 
    // loop over reconstructed tracks, make a selection and fill histograms
 
    for (const auto& track : m_tracks) {
      // track selection
      TOPTrack trk(track);
      if (not trk.isValid()) continue;
      if (not m_selector.isSelected(trk)) continue;
 
      // fill histograms
      auto timeStamp = getObjectPtr<TProfile>("timeStamp");
      timeStamp->Fill(0.5, m_eventMetaData->getTime() / 1000000000);
 
      int slot = trk.getModuleID();
      auto numTracks = getObjectPtr<TH1F>("numTracks");
      numTracks->Fill(slot);
 
      auto muonZ = getObjectPtr<TH1F>(m_muonZNames[slot - 1]);
      muonZ->Fill(m_selector.getLocalPosition().Z());
 
      auto signalHits = getObjectPtr<TH1F>(m_signalNames[slot - 1]);
      auto bkgHits = getObjectPtr<TH1F>(m_bkgNames[slot - 1]);
      auto pulseHeight = getObjectPtr<TH2F>(m_pulseHeightNames[slot - 1]);
      for (const auto& digit : m_digits) {
        if (digit.getModuleID() != slot) continue;
        if (digit.getHitQuality() != TOPDigit::c_Good) continue;  // junk hit or pixel masked-out
        if (not m_thresholdEff->isCalibrated(slot, digit.getChannel())) continue;  // threshold effi. not calibrated
        double effi = m_thresholdEff->getThrEff(slot, digit.getChannel());
        if (effi < m_minThresholdEffi) continue; // to suppress possibly unreliable calibration
        if (std::abs(digit.getTime()) > m_timeWindow) continue;
        // fill signal and background hits with weight=1/effi to correct for threshold efficiency
        if (digit.getTime() > 0) {
          signalHits->Fill(digit.getPixelID(), 1 / effi);
          pulseHeight->Fill(digit.getPixelID(), digit.getPulseHeight());
        } else {
          bkgHits->Fill(digit.getPixelID(), 1 / effi);
        }
      }
 
      auto activePixels = getObjectPtr<TH1F>(m_activeNames[slot - 1]);
      const auto& chMapper = TOPGeometryPar::Instance()->getChannelMapper();
      for (int pixel = 1; pixel <= activePixels->GetNbinsX(); pixel++) {
        unsigned channel = chMapper.getChannel(pixel);
        if (not m_thresholdEff->isCalibrated(slot, channel)) continue; // pixel excluded in counting hits
        if (m_thresholdEff->getThrEff(slot, channel) < m_minThresholdEffi) continue; // pixel excluded in counting hits
        if (m_channelMask->isActive(slot, channel) and m_asicMask->isActive(slot, channel)) activePixels->Fill(pixel);
      }
 
      if (std::abs(m_selector.getLocalPosition().Z()) > m_excludedZ) {
        auto alphaLow = getObjectPtr<TH1F>(m_alphaLowNames[slot - 1]);
        auto alphaHigh = getObjectPtr<TH1F>(m_alphaHighNames[slot - 1]);
        for (const auto& digit : m_digits) {
          if (digit.getModuleID() != slot) continue;
          if (digit.getHitQuality() != TOPDigit::c_Good) continue;  // junk hit or pixel masked-out
          const auto* pdf = digit.getRelated<TOPAssociatedPDF>();
          if (not pdf) continue;
          const auto* peak = pdf->getSinglePeak();
          if (not peak) continue;  // hit associated with background
          double alpha = acos(std::abs(peak->kzd)) / Unit::deg;
          if (alpha > 60) continue;
          if (alpha < 30) alphaLow->Fill(digit.getPixelID());
          else alphaHigh->Fill(digit.getPixelID());
        }
      }
    }
 
  }

collect() [10/11]

void collect ( )

finalprivatevirtual

Replacement for event().

Fill your calibration data objects here

Reimplemented from CalibrationCollectorModule.

Definition at line 90 of file TOPPulseHeightCollectorModule.cc.

  {
 
    std::vector<TH2F*> slots;
    for (const auto& name : m_names) {
      auto h = getObjectPtr<TH2F>(name);
      slots.push_back(h);
    }
 
    auto h1a = getObjectPtr<TH1F>("time");
    auto h1b = getObjectPtr<TH1F>("time_sel");
    auto h2a = getObjectPtr<TH2F>("ph_vs_width");
    auto h2b = getObjectPtr<TH2F>("ph_vs_width_sel");
 
    for (const auto& digit : m_digits) {
      if (digit.getHitQuality() != TOPDigit::c_Good) continue;
      auto t = digit.getTime();
      auto w = digit.getPulseWidth();
      auto ph = digit.getPulseHeight();
      h1a->Fill(t);
      h2a->Fill(w, ph);
      if (m_widthWindow.size() == 2) {
        if (w < m_widthWindow[0] or w > m_widthWindow[1]) continue;
      }
      if (m_timeWindow.size() == 2) {
        if (t < m_timeWindow[0] or t > m_timeWindow[1]) continue;
      }
      h1b->Fill(t);
      h2b->Fill(w, ph);
      unsigned m = digit.getModuleID() - 1;
      if (m < slots.size()) slots[m]->Fill(digit.getChannel(), ph);
    }
 
  }

collect() [11/11]

void collect ( )

finalprivatevirtual

Replacement for event().

Fill your calibration data objects here

Reimplemented from CalibrationCollectorModule.

Definition at line 233 of file TOPValidationCollectorModule.cc.

  {
    // bunch must be reconstructed
 
    if (not m_recBunch.isValid()) return;
    if (not m_recBunch->isReconstructed()) return;
 
    TOPRecoManager::setDefaultTimeWindow();
    const auto& chMapper = TOPGeometryPar::Instance()->getChannelMapper();
 
    // loop over reconstructed tracks, make a selection and accumulate log likelihoods
 
    for (const auto& track : m_tracks) {
 
      // track selection
      TOPTrack trk(track);
      if (not trk.isValid()) continue;
 
      if (not m_selector.isSelected(trk)) continue;
 
      // construct PDF
      PDFConstructor pdfConstructor(trk, m_selector.getChargedStable(), m_PDFOption);
      if (not pdfConstructor.isValid()) continue;
 
      // minimization procedure: accumulate
      unsigned module = trk.getModuleID() - 1;
      if (module >= m_namesChi.size()) continue;
      auto h = getObjectPtr<TH2F>(m_namesChi[module]);
      int set = gRandom->Integer(c_numSets); // generate sub-sample number
      auto& finder = m_finders[set][module];
      for (int ibin = 0; ibin < h->GetNbinsY(); ibin++) {
        double t0 = h->GetYaxis()->GetBinCenter(ibin + 1);
        const auto& pixelLogLs = pdfConstructor.getPixelLogLs(t0, m_sigmaSmear);
        for (unsigned channel = 0; channel < c_numChannels; channel++) {
          int pix = chMapper.getPixelID(channel) - 1;
          double chi = h->GetBinContent(channel + 1, ibin + 1);
          chi += -2 * pixelLogLs[pix].logL;
          h->SetBinContent(channel + 1, ibin + 1, chi);
        }
        double logL = 0;
        for (auto& LL : pixelLogLs) logL += LL.logL;
        finder.add(ibin, -2 * logL);
      }
      m_treeEntry.numTracks++;
 
      auto h1 = getObjectPtr<TH2F>(m_namesHit[module]);
      for (const auto& digit : m_digits) {
        if (digit.getHitQuality() != TOPDigit::c_Good) continue;
        if (digit.getModuleID() != trk.getModuleID()) continue;
        h1->Fill(digit.getChannel(), digit.getTime());
      }
 
    }
  }

defineHisto() [1/7]

void defineHisto ( )

overridevirtual

Histogram definitions such as TH1(), TH2(), TNtuple(), TTree()....

are supposed to be placed in this function.

Reimplemented from HistoModule.

Definition at line 59 of file TOPDQMModule.cc.

  {
    // Create a separate histogram directory and cd into it.
 
    TDirectory* oldDir = gDirectory;
    oldDir->mkdir(m_histogramDirectoryName.c_str())->cd();
 
    // Variables needed for booking
 
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    m_numModules = geo->getNumModules();
    m_bunchTimeSep = geo->getNominalTDC().getSyncTimeBase() / 24;
 
    // Histograms
 
    m_BoolEvtMonitor = new TH1D("BoolEvtMonitor", "Event synchronization", 2, -0.5, 1.5);
    m_BoolEvtMonitor->GetYaxis()->SetTitle("number of digits");
    m_BoolEvtMonitor->GetXaxis()->SetBinLabel(1, "synchronized");
    m_BoolEvtMonitor->GetXaxis()->SetBinLabel(2, "de-synchronized");
    m_BoolEvtMonitor->GetXaxis()->SetLabelSize(0.05);
    m_BoolEvtMonitor->GetXaxis()->SetAlphanumeric();
    m_BoolEvtMonitor->SetMinimum(0);
 
    m_window_vs_slot = new TH2F("window_vs_slot", "Asic windows", 16, 0.5, 16.5, 512, 0, 512);
    m_window_vs_slot->SetXTitle("slot number");
    m_window_vs_slot->SetYTitle("window number w.r.t reference window");
    m_window_vs_slot->SetStats(kFALSE);
    m_window_vs_slot->SetMinimum(0);
    m_window_vs_slot->GetXaxis()->SetNdivisions(16);
 
    int nbinsT0 = 75;
    double rangeT0 = nbinsT0 * m_bunchTimeSep;
    m_eventT0 = new TH1F("eventT0", "Event T0; event T0 [ns]; events per bin", nbinsT0, -rangeT0 / 2, rangeT0 / 2);
 
    m_bunchOffset = new TH1F("bunchOffset", "Bunch offset", 100, -m_bunchTimeSep / 2, m_bunchTimeSep / 2);
    m_bunchOffset->SetXTitle("offset [ns]");
    m_bunchOffset->SetYTitle("events per bin");
    m_bunchOffset->SetMinimum(0);
 
    m_time = new TH1F("goodHitTimes", "Time distribution of good hits", 1000, -20, 80);
    m_time->SetXTitle("time [ns]");
    m_time->SetYTitle("hits per bin");
 
    m_timeBG = new TH1F("goodHitTimesBG", "Time distribution of good hits (background)", 1000, -20, 80);
    m_timeBG->SetXTitle("time [ns]");
    m_timeBG->SetYTitle("hits per bin");
 
    m_signalHits = new TProfile("signalHits", "Number of good hits per track in [0, 50] ns", 16, 0.5, 16.5, 0, 1000);
    m_signalHits->SetXTitle("slot number");
    m_signalHits->SetYTitle("hits per track");
    m_signalHits->SetMinimum(0);
    m_signalHits->GetXaxis()->SetNdivisions(16);
 
    m_backgroundHits = new TProfile("backgroundHits", "Number of good hits pet track in [-50, 0] ns", 16, 0.5, 16.5, 0, 1000);
    m_backgroundHits->SetXTitle("slot number");
    m_backgroundHits->SetYTitle("hits per track");
    m_backgroundHits->SetMinimum(0);
    m_backgroundHits->GetXaxis()->SetNdivisions(16);
 
    m_trackHits = new TH2F("trackHits", "Number of events w/ and w/o track in the slot", 16, 0.5, 16.5, 2, 0, 2);
    m_trackHits->SetXTitle("slot number");
    m_trackHits->SetYTitle("numTracks > 0");
 
    int nbinsHits = 1000;
    double xmaxHits = 10000;
    m_goodHitsPerEventAll = new TH1F("goodHitsPerEventAll", "Number of good hits per event", nbinsHits, 0, xmaxHits);
    m_goodHitsPerEventAll->GetXaxis()->SetTitle("hits per event");
    m_goodHitsPerEventAll->GetYaxis()->SetTitle("entries per bin");
 
    m_badHitsPerEventAll = new TH1F("badHitsPerEventAll", "Number of junk hits per event", nbinsHits, 0, xmaxHits);
    m_badHitsPerEventAll->GetXaxis()->SetTitle("hits per event");
    m_badHitsPerEventAll->GetYaxis()->SetTitle("entries per bin");
 
    int nbinsTDC = 400;
    double xminTDC = -100;
    double xmaxTDC = 700;
    m_goodTDCAll = new TH1F("goodTDCAll", "Raw time distribution of good hits", nbinsTDC, xminTDC, xmaxTDC);
    m_goodTDCAll->SetXTitle("raw time [samples]");
    m_goodTDCAll->SetYTitle("hits per sample");
 
    m_badTDCAll = new TH1F("badTDCAll", "Raw time distribution of junk hits", nbinsTDC, xminTDC, xmaxTDC);
    m_badTDCAll->SetXTitle("raw time [samples]");
    m_badTDCAll->SetYTitle("hits per sample");
 
    m_TOPOccAfterInjLER  = new TH1F("TOPOccInjLER", "TOPOccInjLER/Time;Time in #mus;Nhits/Time (#mus bins)", 4000, 0, 20000);
    m_TOPOccAfterInjHER  = new TH1F("TOPOccInjHER", "TOPOccInjHER/Time;Time in #mus;Nhits/Time (#mus bins)", 4000, 0, 20000);
    m_TOPEOccAfterInjLER  = new TH1F("TOPEOccInjLER", "TOPEOccInjLER/Time;Time in #mus;Triggers/Time (#mus bins)", 4000, 0, 20000);
    m_TOPEOccAfterInjHER  = new TH1F("TOPEOccInjHER", "TOPEOccInjHER/Time;Time in #mus;Triggers/Time (#mus bins)", 4000, 0, 20000);
 
    for (int i = 0; i < m_numModules; i++) {
      int module = i + 1;
      string name, title;
      TH1F* h1 = 0;
      TH2F* h2 = 0;
 
      name = str(format("window_vs_asic_%1%") % (module));
      title = str(format("Asic windows for slot #%1%") % (module));
      h2 = new TH2F(name.c_str(), title.c_str(), 64, 0, 64, 512, 0, 512);
      h2->SetStats(kFALSE);
      h2->SetXTitle("ASIC number");
      h2->SetYTitle("window number w.r.t reference window");
      h2->SetMinimum(0);
      m_window_vs_asic.push_back(h2);
 
      name = str(format("good_hits_xy_%1%") % (module));
      title = str(format("Distribution of good hits for slot #%1%") % (module));
      h2 = new TH2F(name.c_str(), title.c_str(), 64, 0.5, 64.5, 8, 0.5, 8.5);
      h2->SetStats(kFALSE);
      h2->GetXaxis()->SetTitle("pixel column");
      h2->GetYaxis()->SetTitle("pixel row");
      h2->SetMinimum(0);
      m_goodHitsXY.push_back(h2);
 
      name = str(format("bad_hits_xy_%1%") % (module));
      title = str(format("Distribution of junk hits for slot #%1%") % (module));
      h2 = new TH2F(name.c_str(), title.c_str(), 64, 0.5, 64.5, 8, 0.5, 8.5);
      h2->SetStats(kFALSE);
      h2->GetXaxis()->SetTitle("pixel column");
      h2->GetYaxis()->SetTitle("pixel row");
      h2->SetMinimum(0);
      m_badHitsXY.push_back(h2);
 
      name = str(format("good_hits_asics_%1%") % (module));
      title = str(format("Distribution of good hits for slot #%1%") % (module));
      h2 = new TH2F(name.c_str(), title.c_str(), 64, 0, 64, 8, 0, 8);
      h2->SetStats(kFALSE);
      h2->GetXaxis()->SetTitle("ASIC number");
      h2->GetYaxis()->SetTitle("ASIC channel");
      h2->SetMinimum(0);
      m_goodHitsAsics.push_back(h2);
 
      name = str(format("bad_hits_asics_%1%") % (module));
      title = str(format("Distribution of junk hits for slot #%1%") % (module));
      h2 = new TH2F(name.c_str(), title.c_str(), 64, 0, 64, 8, 0, 8);
      h2->SetStats(kFALSE);
      h2->GetXaxis()->SetTitle("ASIC number");
      h2->GetYaxis()->SetTitle("ASIC channel");
      h2->SetMinimum(0);
      m_badHitsAsics.push_back(h2);
 
      name = str(format("good_TDC_%1%") % (module));
      title = str(format("Raw time distribution of good hits for slot #%1%") % (module));
      h1 = new TH1F(name.c_str(), title.c_str(), nbinsTDC, xminTDC, xmaxTDC);
      h1->GetXaxis()->SetTitle("raw time [samples]");
      h1->GetYaxis()->SetTitle("hits per sample");
      m_goodTDC.push_back(h1);
 
      name = str(format("bad_TDC_%1%") % (module));
      title = str(format("Raw time distribution of junk hits for slot #%1%") % (module));
      h1 = new TH1F(name.c_str(), title.c_str(), nbinsTDC, xminTDC, xmaxTDC);
      h1->GetXaxis()->SetTitle("raw time [samples]");
      h1->GetYaxis()->SetTitle("hits per sample");
      m_badTDC.push_back(h1);
 
      name = str(format("good_timing_%1%") % (module));
      title = str(format("Time distribution of good hits for slot #%1%") % (module));
      h1 = new TH1F(name.c_str(), title.c_str(), 200, -20, 80);
      h1->GetXaxis()->SetTitle("time [ns]");
      h1->GetYaxis()->SetTitle("hits per time bin");
      m_goodTiming.push_back(h1);
 
      name = str(format("good_timing_%1%BG") % (module));
      title = str(format("Time distribution of good hits (background) for slot #%1%") % (module));
      h1 = new TH1F(name.c_str(), title.c_str(), 200, -20, 80);
      h1->GetXaxis()->SetTitle("time [ns]");
      h1->GetYaxis()->SetTitle("hits per time bin");
      m_goodTimingBG.push_back(h1);
 
      name = str(format("good_channel_hits_%1%") % (module));
      title = str(format("Distribution of good hits for slot #%1%") % (module));
      int numPixels = geo->getModule(i + 1).getPMTArray().getNumPixels();
      h1 = new TH1F(name.c_str(), title.c_str(), numPixels, 0, numPixels);
      h1->GetXaxis()->SetTitle("channel number");
      h1->GetYaxis()->SetTitle("hits per channel");
      h1->SetMinimum(0);
      m_goodChannelHits.push_back(h1);
 
      name = str(format("bad_channel_hits_%1%") % (module));
      title = str(format("Distribution of junk hits for slot #%1%") % (module));
      h1 = new TH1F(name.c_str(), title.c_str(), numPixels, 0, numPixels);
      h1->GetXaxis()->SetTitle("channel number");
      h1->GetYaxis()->SetTitle("hits per channel");
      h1->SetMinimum(0);
      m_badChannelHits.push_back(h1);
 
      name = str(format("pulseHeights_%1%") % (module));
      title = str(format("Average pulse heights for slot #%1%") % (module));
      auto* prof = new TProfile(name.c_str(), title.c_str(), 32, 0.5, 32.5, 0, 2000);
      prof->GetXaxis()->SetTitle("PMT number");
      prof->GetYaxis()->SetTitle("pulse height [ADC counts]");
      prof->SetMarkerStyle(20);
      prof->SetMinimum(0);
      m_pulseHeights.push_back(prof);
    }
 
    // cd back to root directory
    oldDir->cd();
  }

defineHisto() [2/7]

void defineHisto ( )

overridevirtual

Define TTree branches to store fit results for each channel This TTree is saved in an output file given by "histoFileName" parameter of "HistoManager" module.

Reimplemented from HistoModule.

Definition at line 90 of file TOPGainEfficiencyCalculatorModule.cc.

  {
    m_tree = new TTree("tree", "TTree for gain/efficiency monitor summary");
    m_branch[0].push_back(m_tree->Branch("slotId", &m_targetSlotId, "slotId/S"));
    m_branch[0].push_back(m_tree->Branch("pmtId", &m_targetPmtId, "pmtId/S"));
    m_branch[0].push_back(m_tree->Branch("pixelId", &m_pixelId, "pixelId/S"));
    m_branch[0].push_back(m_tree->Branch("pmtChId", &m_pmtChId, "pmtChId/S"));
    m_branch[0].push_back(m_tree->Branch("hvDiff", &m_hvDiff, "hvDiff/S"));
    m_branch[0].push_back(m_tree->Branch("threshold", &m_threshold, "threshold/F"));
    m_branch[0].push_back(m_tree->Branch("thresholdForIntegral", &m_thresholdForIntegral, "thresholdForIntegral/F"));
 
    m_branch[1].push_back(m_tree->Branch("nCalPulse", &m_nCalPulse, "nCalPulse/I"));
    m_branch[1].push_back(m_tree->Branch("hitTimingForGain", &m_hitTiming, "hitTimingForGain/F"));
    m_branch[1].push_back(m_tree->Branch("hitTimingSigmaForGain", &m_hitTimingSigma, "hitTimingSigmaForGain/F"));
    m_branch[1].push_back(m_tree->Branch("nEntriesForGain", &m_nEntries, "nEntriesForGain/I"));
    m_branch[1].push_back(m_tree->Branch("nOverflowEventsForGain", &m_nOverflowEvents, "nOverflowEventsForGain/I"));
    m_branch[1].push_back(m_tree->Branch("meanPulseHeightForGain", &m_meanPulseHeight, "meanPulseHeightForGain/F"));
    m_branch[1].push_back(m_tree->Branch("meanPulseHeightErrorForGain", &m_meanPulseHeightError, "meanPulseHeightErrorForGain/F"));
    m_branch[1].push_back(m_tree->Branch("fitMaxForGain", &m_fitMax, "fitMaxForGain/F"));
    m_branch[1].push_back(m_tree->Branch("gain", &m_gain, "gain/F"));
    m_branch[1].push_back(m_tree->Branch("efficiency", &m_efficiency, "efficiency/F"));
    m_branch[1].push_back(m_tree->Branch("p0ForGain", &m_p0, "p0ForGain/F"));
    m_branch[1].push_back(m_tree->Branch("p1ForGain", &m_p1, "p1ForGain/F"));
    m_branch[1].push_back(m_tree->Branch("p2ForGain", &m_p2, "p2ForGain/F"));
    m_branch[1].push_back(m_tree->Branch("x0ForGain", &m_x0, "x0ForGain/F"));
    m_branch[1].push_back(m_tree->Branch("p0ErrorForGain", &m_p0Error, "p0ErrorForGain/F"));
    m_branch[1].push_back(m_tree->Branch("p1ErrorForGain", &m_p1Error, "p1ErrorForGain/F"));
    m_branch[1].push_back(m_tree->Branch("p2ErrorForGain", &m_p2Error, "p2ErrorForGain/F"));
    m_branch[1].push_back(m_tree->Branch("x0ErrorForGain", &m_x0Error, "x0ErrorForGain/F"));
    m_branch[1].push_back(m_tree->Branch("chisquareForGain", &m_chisquare, "chisquareForGain/F"));
    m_branch[1].push_back(m_tree->Branch("ndfForGain", &m_ndf, "ndfForGain/I"));
    m_branch[1].push_back(m_tree->Branch("funcFullRangeIntegralForGain", &m_funcFullRangeIntegral, "funcFullRangeIntegralForGain/F"));
    m_branch[1].push_back(m_tree->Branch("funcFitRangeIntegralForGain", &m_funcFitRangeIntegral, "funcFitRangeIntegralForGain/F"));
    m_branch[1].push_back(m_tree->Branch("histoFitRangeIntegralForGain", &m_histoFitRangeIntegral, "histoFitRangeIntegralForGain/F"));
    m_branch[1].push_back(m_tree->Branch("histoMeanAboveThreForGain", &m_histoMeanAboveThre, "histoMeanAboveThreForGain/F"));
 
    m_branch[2].push_back(m_tree->Branch("hitTimingForEff", &m_hitTiming, "hitTimingForEff/F"));
    m_branch[2].push_back(m_tree->Branch("hitTimingSigmaForEff", &m_hitTimingSigma, "hitTimingSigmaForEff/F"));
    m_branch[2].push_back(m_tree->Branch("nEntriesForEff", &m_nEntries, "nEntriesForEff/I"));
    m_branch[2].push_back(m_tree->Branch("nOverflowEventsForEff", &m_nOverflowEvents, "nOverflowEventsForEff/I"));
    m_branch[2].push_back(m_tree->Branch("meanPulseHeightForEff", &m_meanPulseHeight, "meanPulseHeightForEff/F"));
    m_branch[2].push_back(m_tree->Branch("meanPulseHeightErrorForEff", &m_meanPulseHeightError, "meanPulseHeightErrorForEff/F"));
    m_branch[2].push_back(m_tree->Branch("histoMeanAboveThreForEff", &m_histoMeanAboveThre, "histoMeanAboveThreForEff/F"));
 
    m_branch[3].push_back(m_tree->Branch("meanIntegral", &m_meanPulseHeight, "meanIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("meanIntegralError", &m_meanPulseHeightError, "meanIntegralError/F"));
    m_branch[3].push_back(m_tree->Branch("nOverflowEventsUseIntegral", &m_nOverflowEvents, "nOverflowEventsUseIntegral/I"));
    m_branch[3].push_back(m_tree->Branch("fitMaxUseIntegral", &m_fitMax, "fitMaxUseIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("gainUseIntegral", &m_gain, "gainUseIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("efficiencyUseIntegral", &m_efficiency, "efficiencyUseIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("p0UseIntegral", &m_p0, "p0UseIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("p1UseIntegral", &m_p1, "p1UseIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("p2UseIntegral", &m_p2, "p2UseIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("x0UseIntegral", &m_x0, "x0UseIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("p0ErrorUseIntegral", &m_p0Error, "p0ErrorUseIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("p1ErrorUseIntegral", &m_p1Error, "p1ErrorUseIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("p2ErrorUseIntegral", &m_p2Error, "p2ErrorUseIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("x0ErrorUseIntegral", &m_x0Error, "x0ErrorUseIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("chisquareUseIntegral", &m_chisquare, "chisquareUseIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("ndfUseIntegral", &m_ndf, "ndfUseIntegral/I"));
    m_branch[3].push_back(m_tree->Branch("funcFullRangeIntegralUseIntegral", &m_funcFullRangeIntegral,
                                         "funcFullRangeIntegralUseIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("funcFitRangeIntegralUseIntegral", &m_funcFitRangeIntegral,
                                         "funcFitRangeIntegralUseIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("histoFitRangeIntegralUseIntegral", &m_histoFitRangeIntegral,
                                         "histoFitRangeIntegralUseIntegral/F"));
    m_branch[3].push_back(m_tree->Branch("histoMeanAboveThreUseIntegral", &m_histoMeanAboveThre, "histoMeanAboveThreUseIntegral/F"));
 
  }

defineHisto() [3/7]

void defineHisto ( )

overridevirtual

create timing-height 2D histograms for all 8192 pixels

Reimplemented from HistoModule.

Definition at line 102 of file TOPLaserHitSelectorModule.cc.

  {
    for (int iPixel = 0 ; iPixel < c_NPixelPerModule * c_NModule ; iPixel++) {
 
      short slotId = (iPixel / c_NPixelPerModule) + 1;
      short pixelId = (iPixel % c_NPixelPerModule) + 1;
      short pmtId = ((pixelId - 1) % c_NPixelPerRow) / c_NChannelPerPMTRow + c_NPMTPerRow * ((pixelId - 1) / (c_NPixelPerModule / 2)) + 1;
      short pmtChId = (pixelId - 1) % c_NChannelPerPMTRow + c_NChannelPerPMTRow * ((pixelId - 1) %
                      (c_NPixelPerModule / 2) / c_NPixelPerRow) + 1;
 
      std::ostringstream pixelstr;
      pixelstr << "s" << std::setw(2) << std::setfill('0') << slotId << "_PMT"
               << std::setw(2) << std::setfill('0') << pmtId
               << "_" << std::setw(2) << std::setfill('0') << pmtChId;
 
      std::ostringstream hnameForgain;
      hnameForgain << "hTimeHeight_gain_" << pixelstr.str();
      std::ostringstream htitleForgain;
      htitleForgain << "2D distribution of hit timing and pulse height for Gain" << pixelstr.str();
      m_TimeHeightHistogramForFit[iPixel] = new TH2F(hnameForgain.str().c_str(), htitleForgain.str().c_str(),
                                                     m_timeHistogramBinning[0], m_timeHistogramBinning[1], m_timeHistogramBinning[2],
                                                     m_chargeHistogramBinning[0], m_chargeHistogramBinning[1],
                                                     m_chargeHistogramBinning[2]);
 
      std::ostringstream hnameForIntegral;
      hnameForIntegral << "hTimeIntegral_gain_" << pixelstr.str();
      std::ostringstream htitleForIntegral;
      htitleForIntegral << "2D distribution of hit timing and integral for Gain" << pixelstr.str();
      m_TimeIntegralHistogramForFit[iPixel] = new TH2F(hnameForIntegral.str().c_str(), htitleForIntegral.str().c_str(),
                                                       m_timeHistogramBinning[0], m_timeHistogramBinning[1], m_timeHistogramBinning[2],
                                                       m_chargeHistogramBinning[3], m_chargeHistogramBinning[4],
                                                       m_chargeHistogramBinning[5]);
 
      std::ostringstream hnameForeff;
      hnameForeff << "hTimeHeight_efficiency_" << pixelstr.str();
      std::ostringstream htitleForeff;
      htitleForeff << "2D distribution of hit timing and pulse height for efficiency" << pixelstr.str();
      m_TimeHeightHistogramForHitRate[iPixel] = new TH2F(hnameForeff.str().c_str(), htitleForeff.str().c_str(),
                                                         m_timeHistogramBinning[0], m_timeHistogramBinning[1], m_timeHistogramBinning[2],
                                                         m_chargeHistogramBinning[0], m_chargeHistogramBinning[1],
                                                         m_chargeHistogramBinning[2]);
    }
 
    const short nAsic = c_NPixelPerModule / c_NChannelPerAsic * c_NChannelPerPMT;
    m_nCalPulseHistogram = new TH1F("hNCalPulse", "number of calibration pulses identificed for each asic",
                                    nAsic, -0.5, nAsic - 0.5);
  }

defineHisto() [4/7]

void defineHisto ( )

overridevirtual

Module funcions to define histograms.

Reimplemented from HistoModule.

Definition at line 98 of file TOPInterimFENtupleModule.cc.

  {
 
    m_tree = new TTree("tree", "TTree for generator output");
 
    std::ostringstream nModuleStr;
    nModuleStr << "[" << c_NModule << "]";
 
    m_tree->Branch("nHit", &m_nHit, "nHit/I");
    m_tree->Branch("eventNum", &m_eventNum, "eventNum/i");
    m_tree->Branch("eventNumCopper", m_eventNumCopper,
                   std::string(std::string("eventNumCopper") + nModuleStr.str() + "/i").c_str());
    m_tree->Branch("ttuTime", m_ttuTime,
                   std::string(std::string("ttuTime") + nModuleStr.str() + "/i").c_str());
    m_tree->Branch("ttcTime", m_ttcTime,
                   std::string(std::string("ttcTime") + nModuleStr.str() + "/i").c_str());
    m_tree->Branch("slotNum", m_slotNum, "slotNum[nHit]/S");
    m_tree->Branch("pixelId", m_pixelId, "pixelId[nHit]/S");
    m_tree->Branch("channelId", m_channelId, "channel[nHit]/S");
    m_tree->Branch("isCalCh", m_isCalCh, "isCalCh[nHit]/O");
    m_tree->Branch("winNum", m_winNum, "winNum[nHit]/S");
    m_tree->Branch("eventWinNum", m_eventWinNum, "eventWinNum[nHit]/S");
    m_tree->Branch("trigWinNum", m_trigWinNum, "trigWinNum[nHit]/S");
    m_tree->Branch("revo9Counter", m_revo9Counter, "revo9Counter[nHit]/S");
    m_tree->Branch("windowsInOrder", m_windowsInOrder, "windowsInOrder[nHit]/O");
    m_tree->Branch("hitQuality", m_hitQuality, "hitQuality[nHit]/b");
    m_tree->Branch("time", m_time, "time[nHit]/F");
    m_tree->Branch("rawTime", m_rawTime, "rawTime[nHit]/F");
    m_tree->Branch("refTime", m_refTime, "refTime[nHit]/F");
    m_tree->Branch("globalRefTime", &m_globalRefTime, "globalRefTime/F");
    m_tree->Branch("sample", m_sample, "sample[nHit]/s");
    m_tree->Branch("height", m_height, "height[nHit]/F");
    m_tree->Branch("integral", m_integral, "integral[nHit]/F");
    m_tree->Branch("width", m_width, "width[nHit]/F");
    m_tree->Branch("peakSample", m_peakSample, "peakSampe[nHit]/s");
    m_tree->Branch("offlineFlag", m_offlineFlag, "offlineFlag[nHit]/B");
    m_tree->Branch("nHitOfflineFE", m_nHitOfflineFE, "nHitOfflineFE[nHit]/S");
    std::ostringstream brstr[2];
    brstr[0] << "winNumList[nHit][" << c_NWindow << "]/S";
    m_tree->Branch("winNumList", m_winNumList, brstr[0].str().c_str());
    if (m_saveWaveform) {
      brstr[1] << "waveform[nHit][" << c_NWaveformSample << "]/S";
      m_tree->Branch("waveform", m_waveform, brstr[1].str().c_str());
    }
    m_tree->Branch("waveformStartSample", m_waveformStartSample, "waveformStartSample[nHit]/S");
    m_tree->Branch("nWaveformSample", m_nWaveformSample, "nWaveformSample[nHit]/s");
 
    m_tree->Branch("nFEHeader", &m_nFEHeader, "nFEHeader/S");
    m_tree->Branch("nEmptyFEHeader", &m_nEmptyFEHeader, "nEmptyFEHeader/S");
    m_tree->Branch("nWaveform", &m_nWaveform, "nWaveform/S");
    m_tree->Branch("errorFlag", &m_errorFlag, "errorFlag/i");
    m_tree->Branch("eventErrorFlag", &m_eventErrorFlag, "eventErrorFlag/i");
 
    m_tree->Branch("nDebugInfo", &m_nDebugInfo, "nDebugInfo/I");
    m_tree->Branch("scordCtime", m_scrodCtime, "scrodCtime[nDebugInfo]/s");
    m_tree->Branch("phase", m_phase, "phase[nDebugInfo]/s");
    m_tree->Branch("asicMask", m_asicMask, "asicMask[nDebugInfo]/s");
    m_tree->Branch("eventQueuDepth", m_eventQueuDepth, "eventQueuDepth[nDebugInfo]/s");
    m_tree->Branch("eventNumberByte", m_eventNumberByte, "eventNumberByte[nDebugInfo]/s");
  }

defineHisto() [5/7]

void defineHisto ( )

overridevirtual

Histogram definitions such as TH1(), TH2(), TNtuple(), TTree()....

are supposed to be placed in this function.

Reimplemented from HistoModule.

Definition at line 69 of file TOPPDFCheckerModule.cc.

  {
 
    // time vs. pixel ID
    m_hits = new TH2F("hits", "photon hits", 512, 0.5, 512.5,
                      m_numBins, m_minTime, m_maxTime);
    m_hits->SetXTitle("pixel ID");
    m_hits->SetYTitle("time [ns]");
 
    m_pdf = new TH2F("pdf", "PDF", 512, 0.5, 512.5,
                     m_numBins, m_minTime, m_maxTime);
    m_pdf->SetXTitle("pixel ID");
    m_pdf->SetYTitle("time [ns]");
 
    // time vs pixel column
    m_hitsCol = new TH2F("hitsCol", "photon hits", 64, 0.5, 64.5,
                         m_numBins, m_minTime, m_maxTime);
    m_hitsCol->SetXTitle("pixel column");
    m_hitsCol->SetYTitle("time [ns]");
 
    m_pdfCol = new TH2F("pdfCol", "PDF", 64, 0.5, 64.5,
                        m_numBins, m_minTime, m_maxTime);
    m_pdfCol->SetXTitle("pixel column");
    m_pdfCol->SetYTitle("time [ns]");
 
  }

defineHisto() [6/7]

void defineHisto ( )

overridevirtual

Defining the histograms.

Reads once the m_inputDirectoryList to initialize the proper amount of histograms. Every new histogram added to the module has to be initialized here.

Reimplemented from HistoModule.

Definition at line 61 of file TOPTBCComparatorModule.cc.

  {
    // opens the file contining the list of directories and the labels
    ifstream inputDirectoryListFile(m_inputDirectoryList.c_str());
 
    // checks the input file
    if (!inputDirectoryListFile) {
      B2ERROR("Unable to open the input file with the list of CalSets to analyze");
      return;
    }
 
    B2INFO("Initializing histograms");
 
 
    std::string inputString;
 
    // reads the Input file line by-line to initialize the correct number of histogram sets, and reads the labels..
    // This is effectively a loop over all the calsets.
    while (std::getline(inputDirectoryListFile, inputString)) {
 
      // This initializes m_calSetDirectory and m_calSetLabel, even if now only m_calSetLabel will be used
      parseInputDirectoryLine(inputString);
 
      B2INFO("Initializing histograms for Calibration set located at " << m_calSetDirectory << " with label " << m_calSetLabel);
 
      // To be used to initialize the histograms in the following
      std::string name;
      std::string title;
 
 
      // ------
      // Calset-by-calset histograms.
      // initialize here all the histograms that appear once per calibration set, and not slot-by-slot
      // ------
 
      // Average DeltaT across the whole detector
      name = str(format("TOPAverageDeltaT_CalSet_%1%") % m_calSetLabel);
      title = str(format("Average value of #Delta T VS global channel number. CalSet %1%") %  m_calSetLabel);
      m_topAverageDeltaT.push_back(new TH1F(name.c_str(), title.c_str(), 512 * 16, 0., 512 * 16.));
 
      // St.dev. of Delta T across the whole detector
      name = str(format("TOPSigmaDeltaT_CalSet_%1%") % m_calSetLabel);
      title = str(format("Sigma value of #Delta T VS global channel number. CalSet %1%") %  m_calSetLabel);
      m_topSigmaDeltaT.push_back(new TH1F(name.c_str(), title.c_str(), 512 * 16, 0., 512 * 16.));
 
      // Average occupancy agross the whole detector
      name = str(format("TOPSampleOccupancy_CalSet_%1%") % m_calSetLabel);
      title = str(format("Average number of calpulses per sample VS global channel number.  CalSet %1%") %  m_calSetLabel);
      m_topSampleOccupancy.push_back(new TH1F(name.c_str(), title.c_str(), 512 * 16, 0., 512 * 16.));
 
 
      // Ratio of the average DeltaT across the whole detector
      name = str(format("TOPAverageDeltaTComparison_CalSet_%1%") %  m_calSetLabel);
      title = str(format("Ratio of the average #Delta T in CalSet %1% over the previous one, over the whole detector") %  m_calSetLabel);
      m_topAverageDeltaTComparison.push_back(new TH1F(name.c_str(), title.c_str(), 512 * 16, 0., 512 * 16.));
 
      // Ratio of the st.dev on DeltaT across the whole detector
      name = str(format("TOPSigmaDeltaTComparison_CalSet_%1%") % m_calSetLabel);
      title = str(format("Ratio of the st. dev. of #Delta T in CalSet %1% over the previous one, , over the whole detector")  %
                  m_calSetLabel);
      m_topSigmaDeltaTComparison.push_back(new TH1F(name.c_str(), title.c_str(), 512 * 16, 0., 512 * 16.));
 
      // Ratio of the average number of calpulses across the whole detector
      name = str(format("TOPSampleOccupancyComparison_CalSet_%1%") %  m_calSetLabel);
      title = str(
                format("Ratio of the average number of calpulses per sample in CalSet %1% over the previous one, over the whole detector") %
                m_calSetLabel);
      m_topSampleOccupancyComparison.push_back(new TH1F(name.c_str(), title.c_str(), 512 * 16, 0., 512 * 16.));
 
 
      // ------
      // Slot-by-slot histograms.
      // Use this loop to initialize  all the histograms that appear once per calibration set and per each slot
      // ------
      for (int iSlot = 0; iSlot < 16; iSlot ++) {
 
        // Average DeltaT stuff
        name = str(format("SlotAverageDeltaT_Slot%1%_CalSet_%2%") % (iSlot) % m_calSetLabel);
        title = str(format("Average value of #Delta T VS Channel number.  Slot %1%, CalSet %2%") % (iSlot) % m_calSetLabel);
        m_slotAverageDeltaT[iSlot].push_back(new TH1F(name.c_str(), title.c_str(), 512, 0., 512.));
 
        name = str(format("SlotSigmaDeltaT_Slot%1%_CalSet_%2%") % (iSlot) % m_calSetLabel);
        title = str(format("Standard deviation of #Delta T VS Channel number.  Slot %1%, CalSet %2%") % (iSlot) % m_calSetLabel);
        m_slotSigmaDeltaT[iSlot].push_back(new TH1F(name.c_str(), title.c_str(), 512, 0., 512.));
 
        name = str(format("SlotAverageDeltaTMap_Slot%1%_CalSet_%2%") % (iSlot) % m_calSetLabel);
        title = str(format("Map of the average value of #Delta T on the 256 samples.  Slot %1%, CalSet %2%") % (iSlot) % m_calSetLabel);
        m_slotAverageDeltaTMap[iSlot].push_back(new TH2F(name.c_str(), title.c_str(), 64, 0., 64., 8, 0., 8.));
 
        name = str(format("SlotSigmaDeltaTMap_Slot%1%_CalSet_%2%") % (iSlot) % m_calSetLabel);
        title = str(format("Map of the RMS of #Delta T on the 256 samples .  Slot %1%, CalSet %2%") % (iSlot) % m_calSetLabel);
        m_slotSigmaDeltaTMap[iSlot].push_back(new TH2F(name.c_str(), title.c_str(), 64, 0., 64., 8, 0., 8.));
 
 
        // Occupancy stuff
        name = str(format("SlotSampleOccupancy_Slot%1%_CalSet_%2%") % (iSlot) % m_calSetLabel);
        title = str(format("Average occupancy per sample. Slot %1%, CalSet %2%") % (iSlot) % m_calSetLabel);
        m_slotSampleOccupancy[iSlot].push_back(new TH1F(name.c_str(), title.c_str(), 512, 0., 512.));
 
        name = str(format("SlotEmptySamples_Slot%1%_CalSet_%2%") % (iSlot) % m_calSetLabel);
        title = str(format("Number samples with less than %3% calpulses per each slot channel. Slot %1%, CalSet %2%") %
                    (iSlot) % m_calSetLabel % m_minCalPulses);
        m_slotEmptySamples[iSlot].push_back(new TH1F(name.c_str(), title.c_str(), 512, 0., 512.));
 
        name = str(format("SlotSampleOccupancyMap_Slot%1%_CalSet_%2%") % (iSlot) % m_calSetLabel);
        title = str(format("Map of the average occupancy per sample. Slot %1%, CalSet %2%") %
                    (iSlot) % m_calSetLabel);
        m_slotSampleOccupancyMap[iSlot].push_back(new TH2F(name.c_str(), title.c_str(), 64, 0., 64., 8, 0., 8.));
 
        name = str(format("SlotEmptySamplesMap_Slot%1%_CalSet_%2%") % (iSlot) % m_calSetLabel);
        title = str(format("Map of the number samples with less than %3% calpulses per each. Slot %1%, CalSet %2%") %
                    (iSlot) % m_calSetLabel % m_minCalPulses);
        m_slotEmptySamplesMap[iSlot].push_back(new TH2F(name.c_str(), title.c_str(), 64, 0., 64., 8, 0., 8.));
 
 
 
        // Ratios
        name = str(format("SlotAverageDeltaTComparison_Slot%1%_CalSet_%2%") % (iSlot) % m_calSetLabel);
        title = str(format("Ratio of the average #Delta T in CalSet %2% over the previous one.  Slot %1%") % (iSlot) % m_calSetLabel);
        m_slotAverageDeltaTComparison[iSlot].push_back(new TH1F(name.c_str(), title.c_str(), 512, 0., 512.));
 
        name = str(format("SlotRMSDeltaTComparison_Slot%1%_CalSet_%2%") % (iSlot) % m_calSetLabel);
        title = str(format("Ratio of the RMS of #Delta T in CalSet %2% over the previous one.  Slot %1%") % (iSlot) % m_calSetLabel);
        m_slotSigmaDeltaTComparison[iSlot].push_back(new TH1F(name.c_str(), title.c_str(), 512, 0., 512.));
 
        name = str(format("SlotAverageDeltaTMapComparison_Slot%1%_CalSet_%2%") % (iSlot) % m_calSetLabel);
        title = str(format("Map of the ratio of the average #Delta T in CalSet %2% over the previous one.  Slot %1%") %
                    (iSlot) % m_calSetLabel);
        m_slotAverageDeltaTMapComparison[iSlot].push_back(new TH2F(name.c_str(), title.c_str(), 64, 0., 64., 8, 0., 8.));
 
        name = str(format("SlotRMSDeltaTMapComparison_Slot%1%_CalSet_%2%") % (iSlot) % m_calSetLabel);
        title = str(format("Map of the ratio of the RMS of #Delta T in CalSet %2% over the previous one.  Slot %1%") %
                    (iSlot) % m_calSetLabel);
        m_slotSigmaDeltaTMapComparison[iSlot].push_back(new TH2F(name.c_str(), title.c_str(), 64, 0., 64., 8, 0., 8.));
 
      }
 
      //counts how many sets are there. To be used when doing the ratios
      m_totCalSets++;
    }
    B2INFO("Initialization of the histograms for " << m_totCalSets << " CalSets done.");
    return;
  }

defineHisto() [7/7]

void defineHisto ( )

overridevirtual

Books the empty histograms.

Reimplemented from HistoModule.

Definition at line 51 of file TOPWaveformQualityPlotterModule.cc.

  {
    TDirectory* oldDir = gDirectory;
    m_directory = oldDir->mkdir(m_histogramDirectoryName.c_str());
    m_directory->cd();
    m_samples = new TH1F("ADCvalues", "ADC values ", 100, -50, 50);
    m_samples->GetXaxis()->SetTitle("ADC Value");
    m_samples->GetYaxis()->SetTitle("Number of Samples");
    m_scrod_id = new TH1F("scrodID", "scrodID", 100, 0, 100);
    m_asic = new TH1F("IRSX", "IRSX", 4, 0, 4);
    m_carrier = new TH1F("carrier", "asic col", 4, 0, 4);
    m_asic_ch = new TH1F("asicCh", "channel", 8, 0, 8);
    m_errorFlag = new TH1F("errorFlag", "errorFlag", 1000, 0, 1000);
    m_asic_win = new TH1F("window", "window", 4, 0, 4);
    m_entries = new TH1F("entries", "entries", 100, 0, 2600);
    m_moduleID = new TH1F("moduleID", "moduleID", 16, 1, 17);
    m_pixelID = new TH1F("pixelID", "pixelID", 512, 1, 513);
    oldDir->cd();
  }

DrawResult()

void DrawResult	(	const std::string &	histotype,
		EHistogramType	LoadHisto
	)

Draw results of gain/efficiency calculation for each channel to a given output file.

Definition at line 465 of file TOPGainEfficiencyCalculatorModule.cc.

  {
    std::ostringstream pdfFilename;
    pdfFilename << m_outputPDFFile << "_" << histotype;
    if (m_targetPmtChId != -1)
      pdfFilename << "_" << "ch" << std::setw(2) << std::setfill('0') << m_targetPmtChId;
    pdfFilename << ".pdf";
 
    gStyle->SetFrameFillStyle(0);
    gStyle->SetFillStyle(0);
    gStyle->SetStatStyle(0);
    gStyle->SetOptStat(112210);
    gStyle->SetOptFit(1110);
    TCanvas* canvas = new TCanvas();
    canvas->SetFillStyle(0);
    canvas->Print((pdfFilename.str() + "[").c_str());
 
    TLine* line = new TLine();
    line->SetLineWidth(1);
    line->SetLineStyle(1);
    line->SetLineColor(4);
    TArrow* arrow = new TArrow();
    arrow->SetLineWidth(1);
    arrow->SetLineStyle(1);
    arrow->SetLineColor(3);
    TLatex* latex = new TLatex();
    latex->SetNDC();
    latex->SetTextFont(22);
    latex->SetTextSize(0.05);
    latex->SetTextAlign(32);
    TObject* object;
 
    float threshold;
    if (LoadHisto == c_LoadForFitIntegral) threshold = m_thresholdForIntegral;
    else threshold = m_threshold;
 
    for (int iHisto = 0 ; iHisto < c_NChannelPerPMT ; iHisto++) {
 
      if ((iHisto % c_NChannelPerPage) == 0) {
        canvas->Clear();
        canvas->Divide(c_NPlotsPerChannel, c_NChannelPerPage);
      }
 
      //2D (time vs pulse charge) histogram
      canvas->cd(3 * (iHisto % c_NChannelPerPage) + 1);
      gPad->SetFrameFillStyle(0);
      gPad->SetFillStyle(0);
      TH2F* h2D = m_timeChargeHistogram[iHisto];
      if (h2D) {
        h2D->Draw("colz");
        h2D->GetXaxis()->SetTitle("hit timing [ns]");
        h2D->GetYaxis()->SetTitle("pulse charge [ADC count]");
      }
 
      //timing histogram
      canvas->cd(c_NPlotsPerChannel * (iHisto % c_NChannelPerPage) + 2);
      gPad->SetFrameFillStyle(0);
      gPad->SetFillStyle(0);
      TH1D* hTime = m_timeHistogram[iHisto];
      if (hTime) {
        gPad->SetLogy();
        hTime->Draw();
        hTime->SetLineColor(1);
        hTime->GetXaxis()->SetTitle("hit timing [ns]");
        float binWidth = hTime->GetXaxis()->GetBinUpEdge(1) - hTime->GetXaxis()->GetBinLowEdge(1);
        std::ostringstream ytitle;
        ytitle << "Entries [/(" << binWidth << " ns)]";
        hTime->GetYaxis()->SetTitle(ytitle.str().c_str());
 
        TF1* funcLaser = m_funcForLaser[iHisto];
        if (funcLaser) {
          double charge = funcLaser->GetParameter(0);
          double peakTime = funcLaser->GetParameter(1);
          float xMin = hTime->GetXaxis()->GetBinLowEdge(hTime->GetXaxis()->FindBin(peakTime - 2 * m_fitHalfWidth));
          float xMax = hTime->GetXaxis()->GetBinUpEdge(hTime->GetXaxis()->FindBin(peakTime + 2 * m_fitHalfWidth));
          line->DrawLine(xMin, 0.5, xMin, charge * 2.);
          line->DrawLine(xMax, 0.5, xMax, charge * 2.);
          arrow->DrawArrow(xMin, charge * 1.5, xMax, charge * 1.5, 0.01, "<>");
        }
      }
 
      //charge histogram with fit result (after timing cut)
      canvas->cd(c_NPlotsPerChannel * (iHisto % c_NChannelPerPage) + 3);
      gPad->SetFrameFillStyle(0);
      gPad->SetFillStyle(0);
      TH1D* hCharge = m_chargeHistogram[iHisto];
      if (hCharge) {
        gPad->SetLogy();
        hCharge->Draw();
        hCharge->SetLineColor(1);
        hCharge->GetXaxis()->SetTitle("charge [ADC counts]");
        float binWidth = hCharge->GetXaxis()->GetBinUpEdge(1) - hCharge->GetXaxis()->GetBinLowEdge(1);
        std::ostringstream ytitle;
        ytitle << "Entries [/(" << binWidth << " ADC counts)]";
        hCharge->GetYaxis()->SetTitle(ytitle.str().c_str());
 
        if (m_funcForFitRange[iHisto] && m_funcForFullRange[iHisto]) {
          m_funcForFullRange[iHisto]->Draw("same");
          m_funcForFitRange[iHisto]->Draw("same");
          double charge = hCharge->GetBinContent(hCharge->GetMaximumBin());
          line->DrawLine(threshold, 0.5, threshold, charge * 2.);
 
          if ((object = gROOT->FindObject("dummy"))) delete object;
          std::ostringstream cut;
          cut << "pmtChId==" << (iHisto + 1);
          long nEntries = 0;
          std::ostringstream summarystr[2];
          if (LoadHisto == c_LoadForFitHeight) {
            nEntries = m_tree->Project("dummy", "gain:efficiency", cut.str().c_str());
            if (nEntries == 1) {
              summarystr[0] << "gain = " << std::setiosflags(std::ios::fixed) << std::setprecision(1)
                            << m_tree->GetV1()[0];
              latex->DrawLatex(0.875, 0.34, summarystr[0].str().c_str());
              summarystr[1] << "efficiency = " << std::setiosflags(std::ios::fixed) << std::setprecision(1)
                            << (m_tree->GetV2()[0] * 100) << " %";
              latex->DrawLatex(0.875, 0.29, summarystr[1].str().c_str());
            }
          } else if (LoadHisto == c_LoadForFitIntegral) {
            nEntries = m_tree->Project("dummy", "gainUseIntegral:efficiencyUseIntegral", cut.str().c_str());
            if (nEntries == 1) {
              summarystr[0] << "gain = " << std::setiosflags(std::ios::fixed) << std::setprecision(1)
                            << m_tree->GetV1()[0];
              latex->DrawLatex(0.875, 0.34, summarystr[0].str().c_str());
              summarystr[1] << "efficiency = " << std::setiosflags(std::ios::fixed) << std::setprecision(1)
                            << (m_tree->GetV2()[0] * 100) << " %";
              latex->DrawLatex(0.875, 0.29, summarystr[1].str().c_str());
            }
          }
 
          if (nEntries > 1) {
            B2WARNING("TOPGainEfficiencyCalculator : mutliple entries with the same channel ID ("
                      << m_pmtChId << ") in the output TTree");
          }
        }
      }
 
      if (((iHisto + 1) % c_NChannelPerPage) == 0)
        canvas->Print(pdfFilename.str().c_str());
    }
    for (int iHisto = (c_NChannelPerPMT - 1) % c_NChannelPerPage + 1 ; iHisto < c_NChannelPerPage ; iHisto++) {
      for (int iPad = 0 ; iPad < c_NPlotsPerChannel ; iPad++) {
        canvas->cd(c_NPlotsPerChannel * (iHisto % c_NChannelPerPage) + iPad + 1);
        gPad->SetFrameFillStyle(0);
        gPad->SetFillStyle(0);
      }
      if (((iHisto + 1) % c_NChannelPerPage) == 0)
        canvas->Print(pdfFilename.str().c_str());
    }
 
    canvas->Print((pdfFilename.str() + "]").c_str());
 
    delete latex;
    delete arrow;
    delete line;
    delete canvas;
    if ((object = gROOT->FindObject("dummy"))) delete object;
 
    return;
  }

drawWaveforms()

void drawWaveforms

(

const TOPRawWaveform &

rawwave

)

Draws the full waveforms onto the TProfiles.

Parameters

rawwave

the raw waveform

Definition at line 111 of file TOPWaveformQualityPlotterModule.cc.

  {
    vector<short> waveform = v.getWaveform();
    if (waveform.empty()) {
      return;
    }
    int scrodid = v.getScrodID();
    // skip broken events
    if (scrodid == 0) {
      return;
    }
    int asicNumber = v.getASICNumber();
    int carrierNumber = v.getCarrierNumber();
    int iChannel = v.getASICChannel();
    string gname = string("scrod_") + to_string(scrodid) + string("_carrier") + to_string(carrierNumber) + string("_asic") + to_string(
                     asicNumber) + to_string(iChannel);
    if (m_waveformHists[scrodid][carrierNumber][asicNumber].find(iChannel) ==
        m_waveformHists[scrodid][carrierNumber][asicNumber].end()) {
      // FIXME ? This assumes exactly 256 samples in a waveform (FE data)
      auto h = new TProfile(gname.c_str(), gname.c_str(), 256, 0, 256);
      h->Sumw2(false); // unweighted filling.
      m_waveformHists[scrodid][carrierNumber][asicNumber][iChannel] = h;
    }
    // FIXME assumes 256 samples in a waveform
    for (size_t i = 0; i < 256; ++i) {
      // exit broken waveforms early
      if (i >= waveform.size()) {
        break;
      }
      m_waveformHists[scrodid][carrierNumber][asicNumber][iChannel]->Fill(i + 0.5, iChannel * 1500 + waveform[i]);
    }
  }

DummyFillBranch()

void DummyFillBranch

(

EHistogramType

LoadHisto

)

Fill Dummy for Branch.

Use it when there aren't 2D-Histogram.

Definition at line 432 of file TOPGainEfficiencyCalculatorModule.cc.

  {
    m_fitMax = -1;
    m_hitTiming = -1;
    m_hitTimingSigma = -1;
    m_nEntries = -1;
    m_nCalPulse = -1;
    m_nOverflowEvents = -1;
    m_meanPulseHeight = -1;
    m_meanPulseHeightError = -1;
    m_gain = -1;
    m_efficiency = -1;
    m_p0 = -1;
    m_p1 = -1;
    m_p2 = -1;
    m_x0 = -1;
    m_p0Error = -1;
    m_p1Error = -1;
    m_p2Error = -1;
    m_x0Error = -1;
    m_chisquare = -1;
    m_ndf = -1;
    m_funcFullRangeIntegral = -1;
    m_funcFitRangeIntegral = -1;
    m_histoFitRangeIntegral = -1;
    m_histoMeanAboveThre = -1;
 
    for (auto itr = m_branch[LoadHisto].begin(); itr != m_branch[LoadHisto].end(); ++itr) {
      (*itr)->Fill();
    }
  }

endRun() [1/17]

void endRun ( void  )

overridevirtual

End-of-run action.

Save run-related stuff, such as statistics.

Reimplemented from Module.

Definition at line 400 of file TOPBackgroundModule.cc.

  {
    B2INFO("TOPBackground: Finished:");
  }

endRun() [2/17]

void endRun ( void  )

overridevirtual

End-of-run action.

Reimplemented from Module.

Definition at line 89 of file TOPChannelT0MCModule.cc.

  {
  }

endRun() [3/17]

void endRun ( void  )

overridevirtual

End-of-run action.

Reimplemented from Module.

Definition at line 149 of file TOPTriggerDigitizerModule.cc.

  {
 
  }

endRun() [4/17]

void endRun ( void  )

overridevirtual

End-of-run action.

Save run-related stuff, such as statistics.

Reimplemented from Module.

Definition at line 219 of file TOPDoublePulseGeneratorModule.cc.

  {
  }

endRun() [5/17]

void endRun ( void  )

overridevirtual

Draw plots to show fitting results for each channel and save them into a given PDF file (outputPDFFile).

Reimplemented from HistoModule.

Definition at line 168 of file TOPGainEfficiencyCalculatorModule.cc.

  {
  }

endRun() [6/17]

void endRun ( void  )

overridevirtual

End-of-run action.

Save run-related stuff, such as statistics.

Reimplemented from HistoModule.

Definition at line 256 of file TOPLaserHitSelectorModule.cc.

  {
  }

endRun() [7/17]

void endRun ( void  )

overridevirtual

End-of-run action.

Save run-related stuff, such as statistics.

Reimplemented from HistoModule.

Definition at line 331 of file TOPInterimFENtupleModule.cc.

  {
  }

endRun() [8/17]

void endRun ( void  )

overridevirtual

End-of-run action.

Save run-related stuff, such as statistics.

Reimplemented from Module.

Definition at line 109 of file TOPLaserCalibratorModule.cc.

  {
  }

endRun() [9/17]

void endRun ( void  )

overridevirtual

End-of-run action.

Save run-related stuff, such as statistics.

Reimplemented from Module.

Definition at line 142 of file TOPMCTrackMakerModule.cc.

  {
  }

endRun() [10/17]

void endRun ( void  )

overridevirtual

End-of-run action.

Save run-related stuff, such as statistics.

Reimplemented from Module.

Definition at line 270 of file TOPNtupleModule.cc.

  {
  }

endRun() [11/17]

void endRun ( void  )

overridevirtual

End-of-run action.

Save run-related stuff, such as statistics.

Reimplemented from Module.

Definition at line 123 of file TOPPackerModule.cc.

  {
  }

endRun() [12/17]

void endRun ( void  )

overridevirtual

End-of-run action.

Save run-related stuff, such as statistics.

Reimplemented from Module.

Definition at line 477 of file TOPRawDigitConverterModule.cc.

  {
  }

endRun() [13/17]

void endRun ( void  )

overridevirtual

End-of-run action.

The main analysis loop over the calibration sets happens here. This function has to be modified only if the directory structure of the TOPTimeBaseCalibrator module output is changed Both the core functions analyzeCalFile() and makeComparisons() are called here.

Reimplemented from HistoModule.

Definition at line 356 of file TOPTBCComparatorModule.cc.

  {
    // opens the file containing the list of directories and the labels
    ifstream inputDirectoryListFile(m_inputDirectoryList.c_str());
 
    // checsk the input file
    if (!inputDirectoryListFile) {
      B2ERROR("Unable to open the input file with the list of CalSets to analyze");
      return;
    }
 
    std::string inputString;
    // reads the Input file line by-line
    while (std::getline(inputDirectoryListFile, inputString)) {
      // This initializes m_calSetDirectory and m_calSetLabel
 
      parseInputDirectoryLine(inputString);
 
      B2INFO("Processing the calibration set located in " << m_calSetDirectory << " and labelled " << m_calSetLabel);
      TSystemDirectory calSetDir(m_calSetDirectory.c_str(), (m_calSetDirectory).c_str());
 
      // lists the content of the directory
      TList* calSetDirContent = calSetDir.GetListOfFiles();
      if (calSetDirContent) {
        TSystemFile* entry;
        TIter next(calSetDirContent);
        while ((entry = (TSystemFile*)next())) {
 
          // gets the name of the entry in the list of the content of m_calSetDirectory
          std::string entryName = entry->GetName();
 
          // Case 1: the entry is already a root file
          if (!entry->IsDirectory() && TString(entryName.c_str()).EndsWith(".root")) {
            // Initializes the file name
            m_calSetFile = new TFile((m_calSetDirectory + entryName).c_str(), " ");
            // Finds out the Slot and BS ID
            int parserStatus = parseSlotAndScrodIDfromFileName(entryName);
            // Fills the histograms
            if (parserStatus == 1)
              analyzeCalFile();
            // Closes the file
            m_calSetFile->Close();
          }
 
          // Case 2: the entry is a sub-foder, containing the rootfiles
          // The default direcotry structure is
          // calSetDirectory/tbc_chxx/*.root,
          // so this should be the normal case
          if (entry->IsDirectory() && entryName != "." && entryName != "..") {
            entryName += "/";
            // resets the directory where to look for root files
            TSystemDirectory calSetSubDir((m_calSetDirectory + entryName).c_str(), (m_calSetDirectory + entryName).c_str());
 
            // lists the content of the directory
            TList* calSetSubDirContent = calSetSubDir.GetListOfFiles();
            if (calSetSubDirContent) {
              TSystemFile* file;
              TIter nextSub(calSetSubDirContent);
              while ((file = (TSystemFile*)nextSub())) {
                // gets the name of the entry in the list of the content of m_calSetDirectory
                std::string fileName = file->GetName();
 
                if (!file->IsDirectory() && TString(fileName.c_str()).EndsWith(".root")) {
                  // Initializes the file name
                  m_calSetFile = new TFile((m_calSetDirectory + entryName + fileName).c_str(), " ");
                  // Finds out the Slot and BS ID
                  int parserStatus = parseSlotAndScrodIDfromFileName(fileName);
                  // Fills the histograms
                  if (parserStatus == 1)
                    analyzeCalFile();
                  // Closes the file
                  m_calSetFile->Close();
                } else if (file->IsDirectory()  && fileName != "." && fileName != "..") {
                  B2WARNING("Additional subdirectory " << fileName << " found in " <<  m_calSetDirectory + entryName <<
                            ", where only .root and .log files are expected ");
                  continue;
                }
 
              }
            }
          }
        }
      } else {
        B2WARNING("Error in creating the TList form the directory " << m_calSetDirectory);
        continue;
      }
      m_calSetID++; // jump to the next directory (i.e. the next calset)
    }
    B2INFO("Analisys concluded.");
 
    makeComparisons();
 
    return;
  }

endRun() [14/17]

void endRun ( void  )

overridevirtual

End-of-run action.

Save run-related stuff, such as statistics.

Reimplemented from Module.

Definition at line 216 of file TOPTimeBaseCalibratorModule.cc.

  {
  }

endRun() [15/17]

void endRun ( void  )

overridevirtual

End-of-run action.

Save run-related stuff, such as statistics.

Reimplemented from Module.

Definition at line 1245 of file TOPUnpackerModule.cc.

  {
    B2INFO("TOPUnpacker: Channels seen per event statistics:");
    B2INFO("TOPUnpacker: nChn\tcount");
    for (auto& entry : m_channelStatistics) {
      B2INFO("TOPUnpacker: " << entry.first << "\t\t" << entry.second);
    }
  }

endRun() [16/17]

void endRun ( void  )

overridevirtual

End-of-run action.

Save run-related stuff, such as statistics.

Reimplemented from Module.

Definition at line 140 of file TOPWaveformFeatureExtractorModule.cc.

  {
  }

endRun() [17/17]

void endRun ( void  )

overridevirtual

End-of-run action.

Save run-related stuff, such as statistics.

Reimplemented from HistoModule.

Definition at line 181 of file TOPWaveformQualityPlotterModule.cc.

  {
    if (m_DRAWWAVES) {
      // Each waveform was stored in a TH1F
      // This now gets transformed to a TGraph
      // All 8 channels for a given ASIC are put in the same TMultiGraph
      // Then we make one canvas of several TMultigraphs for each scrod
      // FIXME: This is going to get called at the end of the run; the mem leak I am introducing here should be fixed by somebody more patient with ROOT memory management than me.
      for (auto scrod_it : m_waveformHists) {
        int scrodid = scrod_it.first;
        string name = string("scrod_") + to_string(scrodid);
        TCanvas* c = new TCanvas(name.c_str(), name.c_str());
        c->Divide(4, 4);
        int canvasPad = 0;
        for (auto carrier_it : scrod_it.second) {
          int carrierNumber = carrier_it.first;
          for (auto asic_it : carrier_it.second) {
            int asicNumber = asic_it.first;
            canvasPad += 1;
            string gname = string("scrod_") + to_string(scrodid) + string("_carrier") + to_string(carrierNumber) + string("_asic") + to_string(
                             asicNumber);
            TMultiGraph* mg = new TMultiGraph(gname.c_str(), gname.c_str());
            for (auto channel_it : asic_it.second) {
              // read the data from the TProfile
              TGraphErrors* g = new TGraphErrors(channel_it.second);
              g->SetMarkerStyle(7);
              mg->Add(g);
            }
            // FIXME nSamples is hard-coded to 256
            TH2F* h = new TH2F(gname.c_str(), gname.c_str(), 256, 0, 256, 8, -500, -500 + 8 * 1500);
            for (int ibin = 0; ibin < 8; ibin++) {
              h->GetYaxis()->SetBinLabel(ibin + 1, to_string(ibin).c_str());
            }
            h->GetYaxis()->SetTickSize(0);
            h->GetYaxis()->SetTickLength(0);
            h->SetStats(0);
            c->cd(canvasPad);
            h->Draw();
            mg->Draw("P");
          }
        }
        m_directory->WriteTObject(c);
      }
    }
  }

event() [1/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 150 of file OpticalGunModule.cc.

  {
    // generate number of photons
    int numPhotons = 1;
    if (m_numPhotons > 0) numPhotons = gRandom->Poisson(m_numPhotons);
 
    // start time
    double startTime = m_startTime;
    if (m_simCalPulses.getEntries() > 0) { // TOPCalPulseGenerator in the path
      startTime += m_simCalPulses[0]->getTime(); // set start time w.r.t cal pulse
    }
 
    // generate photons and store them to MCParticles
    for (int i = 0; i < numPhotons; i++) {
 
      // generate emission point
      double x, y;
      do {
        x = m_diameter * (gRandom->Rndm() - 0.5);
        y = m_diameter * (gRandom->Rndm() - 0.5);
      } while (x * x + y * y > m_diameter * m_diameter / 4.0);
      XYZPoint point(x, y, 0);
 
      // generate direction
      XYZVector direction;
      if (m_angularDistribution == string("uniform")) {
        direction = getDirectionUniform();
      } else if (m_angularDistribution == string("Lambertian")) {
        direction = getDirectionLambertian();
      } else if (m_angularDistribution == string("Gaussian")) {
        direction = getDirectionGaussian();
      } else { // we already have tested the formula and initialized the TF1 in the initialize() method
        direction = getDirectionCustom();
      }
      XYZVector momentum = m_energy * direction;
 
      // check if photon passes the slit
      if (not isInsideSlit(point, direction)) continue;
 
      // generate polarization vector (unpolarized light source assumed)
      double alphaPol = 2.0 * M_PI * gRandom->Rndm();
      XYZVector polarization(cos(alphaPol), sin(alphaPol), 0);
      func::rotateUz(polarization, direction);
 
      // generate emission time
      double emissionTime = gRandom->Gaus(startTime, m_pulseWidth);
 
      // transform to Belle II frame
      point = m_transform * point;
      momentum = m_transform * momentum;
      polarization = m_transform * polarization;
 
      // store generated photon
      auto* part = m_MCParticles.appendNew();
      part->setPDG(0); // optical photon
      part->setMass(0);
      part->setStatus(MCParticle::c_PrimaryParticle);
      part->addStatus(MCParticle::c_StableInGenerator);
      part->setProductionVertex(static_cast<XYZVector>(point));
      part->setProductionTime(emissionTime);
      part->setMomentum(momentum);
      part->setEnergy(m_energy);
      part->setDecayVertex(polarization); // use this location temporary to pass photon polarization to FullSim
    }
 
  }

event() [2/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 162 of file TOPAlignerModule.cc.

  {
 
    // check bunch reconstruction status and run alignment:
    // - if object exists and bunch is found (collision data w/ bunch finder in the path)
    // - if object doesn't exist (cosmic data and other cases w/o bunch finder)
 
    if (m_recBunch.isValid()) {
      if (not m_recBunch->isReconstructed()) return;
    }
 
    // track-by-track iterations
 
    for (const auto& track : m_tracks) {
 
      // construct TOPtrack from mdst track
      TOPTrack trk(track);
      if (not trk.isValid()) continue;
 
      // skip if track not hitting target module
      if (trk.getModuleID() != m_targetMid) continue;
 
      // track selection
      if (not m_selector.isSelected(trk)) continue;
 
      // do an iteration
      int err = m_align.iterate(trk, m_chargedStable);
      m_iter++;
 
      // check number of consecutive failures, and in case reset
      if (err == 0) {
        m_countFails = 0;
      } else if (m_countFails <= m_maxFails) {
        m_countFails++;
      } else {
        B2INFO("Reached maximum allowed number of failed iterations. "
               "Resetting TOPalign object");
        m_align.reset();
        m_countFails = 0;
      }
 
      // get new parameter values and estimated errors
      m_vAlignPars = m_align.getParameters();
      m_vAlignParsErr = m_align.getErrors();
      m_ntrk = m_align.getNumUsedTracks();
      m_errorCode = err;
      m_valid = m_align.isValid();
      m_numPhot = m_align.getNumOfPhotons();
 
      // set other ntuple variables
      const auto& localPosition = m_selector.getLocalPosition();
      m_x = localPosition.X();
      m_y = localPosition.Y();
      m_z = localPosition.Z();
      const auto& localMomentum = m_selector.getLocalMomentum();
      m_p = localMomentum.R();
      m_theta = localMomentum.Theta();
      m_phi = localMomentum.Phi();
      const auto& pocaPosition = m_selector.getPOCAPosition();
      m_pocaR = pocaPosition.Rho();
      m_pocaZ = pocaPosition.Z();
      m_pocaX = pocaPosition.X();
      m_pocaY = pocaPosition.Y();
      m_cmsE = m_selector.getCMSEnergy();
      m_charge = trk.getCharge();
      m_PDG = trk.getPDGCode();
 
      // fill output tree
      m_alignTree->Fill();
 
      // print info
      TString resMsg = "M= ";
      resMsg += m_align.getModuleID();
      resMsg += " ntr=";
      resMsg += m_ntrk;
      resMsg += " err=";
      resMsg += m_errorCode;
      resMsg += " v=";
      resMsg += m_align.isValid();
      for (auto par : m_vAlignPars) {
        resMsg += " ";
        resMsg += par;
      }
      B2DEBUG(20, resMsg);
 
    }
 
  }

event() [3/32]

void event ( void  )

overridevirtual

Event processor.

Convert TOPSimHits of the event to TOPHits.

Reimplemented from Module.

Definition at line 202 of file TOPBackgroundModule.cc.

  {
    StoreArray<TOPSimHit>  topSimhits;
    StoreArray<MCParticle> mcParticles;
    StoreArray<TOPDigit> topDigits;
    StoreArray<TOPBarHit> topTracks;
 
    int nHits = topDigits.getEntries();
    for (int i = 0; i < nHits; i++) {
      TOPDigit* aDigit = topDigits[i];
      int barID = aDigit->getModuleID();
 
      peflux->AddBinContent(barID * 2, 1. / m_TimeOfSimulation / 32.0);
 
      const TOPSimHit* simHit = DataStore::getRelated<TOPSimHit>(aDigit);
      if (!simHit) continue;
      int PMTID = simHit->getPmtID();
 
      module_occupancy->SetPoint(count_occ, PMTID, barID);
      count_occ++;
 
      genergy->Fill(simHit->getEnergy());
 
      const MCParticle* particle = DataStore::getRelated<MCParticle>(simHit);
 
      if (particle) {
        const MCParticle* currParticle = particle;
 
        const MCParticle* mother = currParticle->getMother();
 
        while (mother) {
          const MCParticle* pommother = mother->getMother();
          if (!pommother) {
 
            zdist->Fill(mother->getVertex().Z());
            zdistg->Fill(mother->getVertex().Z(), 1. / m_TimeOfSimulation / 32.0 / 16.0);
            originpe_x = mother->getVertex().X();
            originpe_y = mother->getVertex().Y();
            originpe_z = mother->getVertex().Z();
            originpe->Fill();
            ROOT::Math::XYZVector momentum = mother->getMomentum();
            if (m_BkgType.at(m_BkgType.size() - 3) == 'L') ROOT::Math::VectorUtil::RotateY(momentum, 0.0415);
            else if (m_BkgType.at(m_BkgType.size() - 3) == 'H') ROOT::Math::VectorUtil::RotateY(momentum, -0.0415);
            double px = momentum.X();
            double py = momentum.Y();
            double pt = sqrt(px * px + py * py);
            originpt->Fill(pt);
          }
          mother = pommother;
        }
      }
    }
 
 
    StoreArray<BeamBackHit> beamBackHits;
    nHits = beamBackHits.getEntries();
 
    for (int iHit = 0; iHit < nHits; ++iHit) {
      BeamBackHit* tophit = beamBackHits[iHit];
      int subdet = tophit->getSubDet();
      if (subdet != 5) continue;
 
      auto pos = tophit->getPosition();
      double phi = ROOT::Math::VectorUtil::Phi_0_2pi(pos.Phi()) * TMath::RadToDeg();
      int barID = int (phi / 22.5 + 0.5);
      if (barID == 16) {
        barID = 0;
      }
      barID++;
 
 
      if (tophit->getPDG() == Const::neutron.getPDGCode()) {
        double w = tophit->getNeutronWeight();
        double tlen = tophit->getTrackLength();
 
        nflux->AddBinContent(barID * 2, w / m_TimeOfSimulation / PCBarea * yearns * tlen / 0.2);
 
      } else {
        double edep = tophit->getEnergyDeposit();
        rdose->AddBinContent(barID * 2, edep / m_TimeOfSimulation * yearns / PCBmass * evtoJ);
      }
    }
 
    nHits = topTracks.getEntries();
    for (int iHit = 0; iHit < nHits; ++iHit) {
      TOPBarHit* toptrk = topTracks[iHit];
 
      int PDG = toptrk->getPDG();
      int barID = toptrk->getModuleID();
 
      if (PDG == Const::neutron.getPDGCode()) {
        nflux_bar->Fill(toptrk->getPosition().Z(), (barID - 1) * 22.5,
                        1. / 917.65 / m_TimeOfSimulation * yearns * 2.);
        norigin->Fill(toptrk->getProductionPoint().Z());
      } else {
        if (PDG == Const::photon.getPDGCode()) {
          gflux_bar->Fill(toptrk->getPosition().Z(), (barID - 1) * 22.5,
                          1. / 917.65 / m_TimeOfSimulation * 2.);
          gorigin->Fill(toptrk->getProductionPoint().Z());
          genergy2->Fill(toptrk->getMomentum().R() * 1000);
          origin_zx->SetPoint(count, toptrk->getProductionPoint().Z(),
                              toptrk->getProductionPoint().X());
          origin_zy->SetPoint(count, toptrk->getProductionPoint().Z() / 0.999143,
                              toptrk->getProductionPoint().Y());
          origingamma_x = toptrk->getProductionPoint().X();
          origingamma_y = toptrk->getProductionPoint().Y();
          origingamma_z = toptrk->getProductionPoint().Z();
          origingamma->Fill();
          count++;
 
        } else {
          cflux_bar->Fill(toptrk->getPosition().Z(), (barID - 1) * 22.5,
                          1. / 917.65 / m_TimeOfSimulation * 2.);
          corigin->Fill(toptrk->getProductionPoint().Z());
        }
      }
 
    }
  }

event() [4/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 238 of file TOPBunchFinderModule.cc.

  {
 
    m_processed++;
    TOPRecoManager::setDefaultTimeWindow();
 
    // define output for the reconstructed bunch
 
    if (not m_recBunch.isValid()) {
      m_recBunch.create();
    } else {
      m_revo9Counter = m_recBunch->getRevo9Counter();
      m_recBunch->clearReconstructed();
    }
    m_timeZeros.clear();
 
    if (not m_eventT0.isValid()) m_eventT0.create();
 
    // set MC truth if available
 
    if (m_initialParticles.isValid()) {
      double simTime = m_initialParticles->getTime();
      int simBunchNumber = round(simTime / m_bunchTimeSep);
      m_recBunch->setSimulated(simBunchNumber, simTime);
    }
    m_isMC = m_recBunch->isSimulated();
 
    // set revo9 counter from the first raw digit if available (all should be the same)
 
    if (m_topRawDigits.getEntries() > 0) {
      const auto* rawDigit = m_topRawDigits[0];
      m_revo9Counter = rawDigit->getRevo9Counter();
      m_recBunch->setRevo9Counter(m_revo9Counter);
    }
 
    // full time window in which data are taken (smaller time window is used in reconstruction)
 
    const auto& tdc = TOPGeometryPar::Instance()->getGeometry()->getNominalTDC();
    double timeWindow = m_feSetting->getReadoutWindows() * tdc.getSyncTimeBase() / static_cast<double>(TOPNominalTDC::c_syncWindows);
 
    // counters and temporary containers
 
    int numTrk = 0;
    m_nodEdxCount = 0;
    std::vector<TOPTrack> topTracks;
    std::vector<PDFConstructor> pdfConstructors;
    std::vector<PDF1Dim> top1Dpdfs;
    std::vector<int> numPhotons;
    std::vector<double> assumedMasses;
    std::vector<Chi2MinimumFinder1D> finders;
 
    // loop over reconstructed tracks, make a selection and push to containers
 
    for (const auto& track : m_tracks) {
      TOPTrack trk(track);
      if (not trk.isValid()) continue;
 
      // track selection
      const auto* fitResult = track.getTrackFitResultWithClosestMass(Const::pion);
      if (not fitResult) {
        B2ERROR("No TrackFitResult available. Must be a bug somewhere.");
        continue;
      }
      if (fitResult->getHitPatternCDC().getNHits() < m_minNHitsCDC) continue;
      if (fabs(fitResult->getD0()) > m_maxD0) continue;
      if (fabs(fitResult->getZ0()) > m_maxZ0) continue;
      auto pt = fitResult->getTransverseMomentum();
      if (pt < m_minPt or pt > m_maxPt) continue;
 
      // determine most probable particle mass
      auto chargedStable = Const::pion;
      if (m_useMCTruth) {
        if (not trk.getMCParticle()) continue;
        if (not trk.getBarHit()) continue;
        chargedStable = Const::chargedStableSet.find(abs(trk.getMCParticle()->getPDG()));
        if (chargedStable == Const::invalidParticle) continue;
      } else {
        if (trk.getMomentumMag() < 4.0) chargedStable = getMostProbable(track);
      }
 
      // construct PDF
      PDFConstructor pdfConstructor(trk, chargedStable, PDFConstructor::c_Rough);
      if (not pdfConstructor.isValid()) continue;
      numTrk++;
 
      // make PDF projection to time axis with bin size of ~0.5 ns
      PDF1Dim pdf1d(pdfConstructor, 0.5, timeWindow);
      pdfConstructor.switchOffDeltaRayPDF(); // to speed-up fine search
 
      // do further track selection
      double expSignal = pdf1d.getExpectedSignal();
      double expDelta = pdf1d.getExpectedDeltaPhotons();
      double expBG = pdf1d.getExpectedBG();
      double expPhot = expSignal + expDelta + expBG;
      double numPhot = pdf1d.getNumOfPhotons();
      if (expSignal < m_minSignal) continue;
      if (expSignal < m_minSBRatio * expBG) continue;
      if (numPhot < m_minDERatio * expPhot) continue;
      if (numPhot > m_maxDERatio * expPhot) continue;
 
      topTracks.push_back(trk);
      pdfConstructors.push_back(pdfConstructor);
      top1Dpdfs.push_back(pdf1d);
      numPhotons.push_back(numPhot);
      assumedMasses.push_back(pdfConstructors.back().getHypothesis().getMass());
    }
    m_recBunch->setNumTracks(numTrk, topTracks.size(), m_nodEdxCount);
    if (topTracks.empty()) return;
 
    // get time seed
 
    auto timeSeed = getTimeSeed();
 
    if (timeSeed.sigma == 0) { // time seed is not given - perform coarse search
 
      // set time region for coarse search
 
      double minT0 = -m_timeRangeCoarse / 2;
      double maxT0 = m_timeRangeCoarse / 2;
      if (m_autoRange) {
        minT0 = top1Dpdfs[0].getMinT0();
        maxT0 = top1Dpdfs[0].getMaxT0();
        for (const auto& pdf : top1Dpdfs) {
          minT0 = std::min(minT0, pdf.getMinT0());
          maxT0 = std::max(maxT0, pdf.getMaxT0());
        }
      }
      double binSize = top1Dpdfs[0].getBinSize();
      int numBins = (maxT0 - minT0) / binSize;
      maxT0 = minT0 + binSize * numBins;
 
      // find coarse T0
 
      for (const auto& pdf : top1Dpdfs) {
        finders.push_back(Chi2MinimumFinder1D(numBins, minT0, maxT0));
        auto& finder = finders.back();
        const auto& bins = finder.getBinCenters();
        for (unsigned i = 0; i < bins.size(); i++) {
          double t0 = bins[i];
          finder.add(i, -2 * pdf.getLogL(t0));
        }
      }
      auto coarseFinder = finders[0];
      for (size_t i = 1; i < finders.size(); i++) {
        coarseFinder.add(finders[i]);
      }
 
      const auto& t0Coarse = coarseFinder.getMinimum();
      if (m_saveHistograms) {
        m_recBunch->addHistogram(coarseFinder.getHistogram("chi2_coarse_",
                                                           "coarse T0; t_{0} [ns]; -2 log L"));
      }
      if (t0Coarse.position < minT0 or t0Coarse.position > maxT0 or not t0Coarse.valid) {
        B2DEBUG(20, "Coarse T0 finder: returning invalid or out of range T0");
        return;
      }
      timeSeed.t0 = t0Coarse.position;
    }
 
    // find precise T0
 
    finders.clear();
 
    double timeMin = TOPRecoManager::getMinTime() + timeSeed.t0;
    double timeMax = TOPRecoManager::getMaxTime() + timeSeed.t0;
    double timeRangeFine = std::max(m_timeRangeFine, timeSeed.sigma * 6);
    double t0min = timeSeed.t0 - timeRangeFine / 2;
    double t0max = timeSeed.t0 + timeRangeFine / 2;
 
    for (size_t itrk = 0; itrk < topTracks.size(); itrk++) {
      finders.push_back(Chi2MinimumFinder1D(m_numBins, t0min, t0max));
      const auto& reco = pdfConstructors[itrk];
      numPhotons[itrk] = setFinder(finders.back(), reco, timeMin, timeMax);
      const auto& trk = topTracks[itrk];
      double momentum = trk.getMomentumMag();
      if (not m_useMCTruth and momentum > 0.7 and topTracks.size() <= m_nTrackLimit) {
        std::vector<Const::ChargedStable> other;
        if (reco.getHypothesis() == Const::kaon) {
          other.push_back(Const::pion);
          if (momentum < 4.0) other.push_back(Const::proton);
        } else if (reco.getHypothesis() == Const::proton) {
          other.push_back(Const::pion);
          if (momentum < 2.0) other.push_back(Const::kaon);
        } else {
          if (momentum < 2.0) other.push_back(Const::kaon);
          if (momentum < 4.0) other.push_back(Const::proton);
        }
        for (const auto& chargedStable : other) {
          PDFConstructor pdfConstructor(trk, chargedStable, PDFConstructor::c_Rough);
          if (not pdfConstructor.isValid()) continue;
          pdfConstructor.switchOffDeltaRayPDF(); // to speed-up fine search
          if (pdfConstructor.getExpectedSignalPhotons() < m_minSignal) continue;
          Chi2MinimumFinder1D finder(m_numBins, t0min, t0max);
          int numPhot = setFinder(finder, pdfConstructor, timeMin, timeMax);
          if (numPhot != numPhotons[itrk])
            B2ERROR("Different number of photons used for log likelihood of different mass hypotheses");
          if (finder.getMinChi2() < finders.back().getMinChi2()) {
            finders.back() = finder;
            assumedMasses[itrk] = chargedStable.getMass();
          }
        }
      }
    }
 
    if (finders.size() == 0) return; // just in case
    auto finderSum = finders[0];
    for (size_t i = 1; i < finders.size(); i++) {
      finderSum.add(finders[i]);
    }
 
    if (timeSeed.sigma > 0) {
      const auto& binCenters = finderSum.getBinCenters();
      for (unsigned i = 0; i < binCenters.size(); i++) {
        double t0 = binCenters[i];
        finderSum.add(i, pow((t0 - timeSeed.t0) / timeSeed.sigma, 2)); // add chi2 according to timeSeed resolution
      }
    }
 
    const auto& T0 = finderSum.getMinimum();
    if (m_saveHistograms) {
      m_recBunch->addHistogram(finderSum.getHistogram("chi2_fine_", "precise T0; t_{0} [ns]; -2 log L"));
    }
    if (T0.position < t0min or T0.position > t0max or not T0.valid) {
      B2DEBUG(20, "Fine T0 finder: returning invalid or out of range T0");
      return;
    }
 
    // bunch time and current offset
 
    int bunchNo = lround(T0.position / m_bunchTimeSep); // round to nearest integer
    double offset = T0.position - m_bunchTimeSep * bunchNo;
    if (not m_commonT0->isCalibrated()) { // auto set offset range
      double deltaOffset = offset - m_runningOffset;
      if (fabs(deltaOffset + m_bunchTimeSep) < fabs(deltaOffset)) {
        offset += m_bunchTimeSep;
        bunchNo--;
      } else if (fabs(deltaOffset - m_bunchTimeSep) < fabs(deltaOffset)) {
        offset -= m_bunchTimeSep;
        bunchNo++;
      }
    }
    double error = T0.error;
 
    // averaging with first order filter (with adoptable time constant)
 
    double tau = 10 + m_success / 2;  // empirically with toy MC
    if (tau > m_tau) tau = m_tau;
    double a = exp(-1.0 / tau);
    m_runningOffset = a * m_runningOffset + (1 - a) * offset;
    double err1 = a * m_runningError;
    double err2 = (1 - a) * error;
    m_runningError = sqrt(err1 * err1 + err2 * err2);
 
    // when not running in HLT mode, check if reconstructed bunch is filled
 
    if (not m_HLTmode) {
      bool isFilled = isBucketFilled(bunchNo); // stores in addition the bucket number and fill status in m_recBunch
      if (m_useFillPattern and not isFilled) return;
    }
 
    // store the results
 
    double bunchTime = bunchNo * m_bunchTimeSep;
    m_recBunch->setReconstructed(bunchNo, bunchTime, offset, error, m_runningOffset, m_runningError, timeSeed.detector);
    m_recBunch->setMinChi2(T0.chi2);
    double svdOffset = m_eventT0Offset.isValid() and not m_isMC ? m_eventT0Offset->get(Const::SVD).offset : 0;
    m_eventT0->addTemporaryEventT0(EventT0::EventT0Component(bunchTime + svdOffset, error, Const::TOP, "bunchFinder"));
    m_success++;
 
    // store T0 of single tracks relative to bunchTime
 
    if (finders.size() == topTracks.size()) {
      for (size_t itrk = 0; itrk < topTracks.size(); itrk++) {
        const auto& trk = topTracks[itrk];
        auto& finder = finders[itrk];
        const auto& t0trk = finder.getMinimum();
        auto* timeZero = m_timeZeros.appendNew(trk.getModuleID(),
                                               t0trk.position - bunchTime,
                                               t0trk.error, numPhotons[itrk]);
        timeZero->setAssumedMass(assumedMasses[itrk]);
        if (not t0trk.valid) timeZero->setInvalid();
        timeZero->setMinChi2(finder.getMinChi2());
        timeZero->addRelationTo(trk.getExtHit());
 
        if (m_saveHistograms) {
          std::string num = std::to_string(itrk);
          auto chi2 = finder.getHistogram("chi2_" + num,
                                          "precise T0 single track; t_{0} [ns]; -2 log L");
          auto pdf = top1Dpdfs[itrk].getHistogram("pdf1D_" + num,
                                                  "PDF projected to time axis; time [ns]");
          TH1F hits(("hits_" + num).c_str(),
                    "time distribution of hits (t0-subtracted); time [ns]",
                    pdf.GetNbinsX(), pdf.GetXaxis()->GetXmin(), pdf.GetXaxis()->GetXmax());
          for (const auto& hit : trk.getSelectedHits()) {
            hits.Fill(hit.time - t0trk.position);
          }
          timeZero->setHistograms(chi2, pdf, hits);
        }
      }
    }
 
    // correct time in TOPDigits
 
    if (m_correctDigits) {
      for (auto& digit : m_topDigits) {
        digit.subtractT0(bunchTime);
        digit.addStatus(TOPDigit::c_EventT0Subtracted);
        if (m_HLTmode and m_subtractRunningOffset) {
          digit.subtractT0(m_runningOffset);
          double err = digit.getTimeError();
          digit.setTimeError(sqrt(err * err + m_runningError * m_runningError));
          digit.addStatus(TOPDigit::c_BunchOffsetSubtracted);
        }
      }
    }
 
  }

event() [5/32]

void event ( void  )

overridevirtual

event method: removes channels from the reconstruction pdf, flags hits from noisy channels as junk

Reimplemented from Module.

Definition at line 69 of file TOPChannelMaskerModule.cc.

  {
 
    // have those payloads changed?
 
    bool pmtInstalled = m_pmtInstalled.hasChanged();
    bool pmtQEData = m_pmtQEData.hasChanged();
    bool channelRQE = m_channelRQE.hasChanged();
    bool thresholdEff = m_thresholdEff.hasChanged();
 
    // if at least one then pass pixel relative efficiencies to the reconstructon code
 
    if (pmtInstalled or pmtQEData or channelRQE or thresholdEff) {
      TOPRecoManager::setChannelEffi();
    }
 
    // have asic masks changed?
 
    bool asicMasksChanged = false;
    if (m_eventAsicMask.isValid()) {
      if (m_eventAsicMask->get() != m_savedAsicMask.get()) {
        m_savedAsicMask.set(m_eventAsicMask->get());
        asicMasksChanged = true;
      }
    }
 
    // have channel masks or calibration changed?
 
    bool channelMaskChanged = m_channelMask.hasChanged();
    bool channelT0Changed = m_channelT0.hasChanged();
    bool timebaseChanged = m_timebase.hasChanged();
 
    // if at least one then pass the new masking to the reconstruction code
 
    if (channelMaskChanged or asicMasksChanged or
        (m_maskUncalibratedChannelT0 and channelT0Changed) or
        (m_maskUncalibratedTimebase and timebaseChanged)) {
 
      TOPRecoManager::setChannelMask(m_channelMask, m_savedAsicMask);
      if (m_maskUncalibratedChannelT0) {
        TOPRecoManager::setUncalibratedChannelsOff(m_channelT0);
      }
      if (m_maskUncalibratedTimebase) {
        TOPRecoManager::setUncalibratedChannelsOff(m_timebase);
      }
    }
 
    // now flag actual data Cherenkov hits as coming from masked channels
 
    for (auto& digit : m_digits) {
      // if already set switch the state back to c_Good (e.g. for digits read from file)
      if (digit.getHitQuality() == TOPDigit::c_Masked or
          digit.getHitQuality() == TOPDigit::c_Uncalibrated) {
        digit.setHitQuality(TOPDigit::c_Good);
      }
      if (digit.getHitQuality() != TOPDigit::c_Good) continue;
 
      // now do the new masking of c_Good
      auto slotID = digit.getModuleID();
      auto channel = digit.getChannel();
      if (not m_channelMask->isActive(slotID, channel)) {
        digit.setHitQuality(TOPDigit::c_Masked);
        continue;
      }
      if (not m_savedAsicMask.isActive(slotID, channel)) {
        digit.setHitQuality(TOPDigit::c_Masked);
        const unsigned maxCount = 10; // at HLT this means (10 * number-of-processes) messages before being suppressed
        if (m_errorCount < maxCount) {
          B2ERROR("Unexpected hit found in a channel that is masked-out by firmware"
                  << LogVar("slotID", slotID) << LogVar("channel", channel));
        } else if (m_errorCount == maxCount) {
          B2ERROR("Unexpected hit found in a channel that is masked-out by firmware"
                  << LogVar("slotID", slotID) << LogVar("channel", channel)
                  << LogVar("... message will be suppressed now, errorCount", m_errorCount));
        }
        m_errorCount++;
        continue;
      }
      if (m_maskUncalibratedChannelT0 and not m_channelT0->isCalibrated(slotID, channel)) {
        digit.setHitQuality(TOPDigit::c_Uncalibrated);
        continue;
      }
      if (m_maskUncalibratedTimebase) {
        const auto& fe_mapper = TOPGeometryPar::Instance()->getFrontEndMapper();
        const auto* fe = fe_mapper.getMap(slotID, channel / 128);
        if (not fe) {
          B2ERROR("No front-end map found" << LogVar("slotID", slotID) << LogVar("channel", channel));
          digit.setHitQuality(TOPDigit::c_Uncalibrated);
          continue;
        }
        auto scrodID = fe->getScrodID();
        const auto* sampleTimes = m_timebase->getSampleTimes(scrodID, channel);
        if (not sampleTimes->isCalibrated()) {
          digit.setHitQuality(TOPDigit::c_Uncalibrated);
        }
      }
    }
 
  }

event() [6/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 176 of file TOPChannelT0CalibratorModule.cc.

  {
    /* check bunch reconstruction status and run alignment:
       - if object exists and bunch is found (collision data w/ bunch finder in the path)
       - if object doesn't exist (cosmic data and other cases w/o bunch finder)
    */
 
    if (m_recBunch.isValid()) {
      if (not m_recBunch->isReconstructed()) return;
    }
 
    TOPRecoManager::setDefaultTimeWindow();
    double timeMin = TOPRecoManager::getMinTime();
    double timeMax = TOPRecoManager::getMaxTime();
    const auto& chMapper = TOPGeometryPar::Instance()->getChannelMapper();
 
    // loop over reconstructed tracks, make a selection and accumulate log likelihoods
 
    for (const auto& track : m_tracks) {
 
      // track selection
      TOPTrack trk(track);
      if (not trk.isValid()) continue;
 
      if (not m_selector.isSelected(trk)) continue;
 
      // construct PDF
      PDFConstructor pdfConstructor(trk, m_selector.getChargedStable(), m_PDFOption);
      if (not pdfConstructor.isValid()) continue;
 
      // minimization procedure: accumulate
      const unsigned module = trk.getModuleID() - 1;
      if (module >= c_numModules) continue;
      int sub = gRandom->Integer(2); // generate sub-sample number
      auto& finders = m_finders[sub][module];
      const auto& binCenters = finders[0].getBinCenters();
      for (unsigned ibin = 0; ibin < binCenters.size(); ibin++) {
        double t0 = binCenters[ibin];
        const auto& pixelLogLs = pdfConstructor.getPixelLogLs(t0, m_sigmaSmear);
        for (unsigned channel = 0; channel < c_numChannels; channel++) {
          int pix = chMapper.getPixelID(channel) - 1;
          finders[channel].add(ibin, -2 * pixelLogLs[pix].logL);
        }
      }
 
      // fill histograms of hits
      m_numPhotons = 0;
      for (const auto& digit : m_digits) {
        if (digit.getHitQuality() != TOPDigit::c_Good) continue;
        if (digit.getModuleID() != trk.getModuleID()) continue;
        if (digit.getTime() < timeMin) continue;
        if (digit.getTime() > timeMax) continue;
        m_numPhotons++;
        auto& h1 = m_hits1D[module];
        h1.Fill(digit.getChannel());
        auto& h2 = m_hits2D[module];
        h2.Fill(digit.getChannel(), digit.getTime());
      }
 
      // fill output tree
      m_moduleID = trk.getModuleID();
      const auto& localPosition = m_selector.getLocalPosition();
      m_x = localPosition.X();
      m_y = localPosition.Y();
      m_z = localPosition.Z();
      const auto& localMomentum = m_selector.getLocalMomentum();
      m_p = localMomentum.R();
      m_theta = localMomentum.Theta();
      m_phi = localMomentum.Phi();
      const auto& pocaPosition = m_selector.getPOCAPosition();
      m_pocaR = pocaPosition.Rho();
      m_pocaZ = pocaPosition.Z();
      m_pocaX = pocaPosition.X();
      m_pocaY = pocaPosition.Y();
      m_cmsE = m_selector.getCMSEnergy();
      m_charge = trk.getCharge();
      m_PDG = trk.getPDGCode();
      m_tree->Fill();
    }
 
  }

event() [7/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 67 of file TOPChannelT0MCModule.cc.

  {
 
    for (auto& digit : m_digits) {
      unsigned channel = digit.getChannel();
      if (channel < c_NumChannels) {
        auto histo = m_histo[channel];
        if (!histo) {
          stringstream ss;
          ss << "chan" << channel ;
          string name;
          ss >> name;
          string title = "Times " + name;
          histo = new TH1F(name.c_str(), title.c_str(), (int)m_fitRange[0], m_fitRange[1], m_fitRange[2]);
          m_histo[channel] = histo;
        }
        if (digit.getTime() < m_fitRange[1] || digit.getTime() > m_fitRange[2]) continue;
        histo->Fill(digit.getTime());
      }
    }
  }

event() [8/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 162 of file TOPCommonT0CalibratorModule.cc.

  {
    /* check bunch reconstruction status and run alignment:
       - if object exists and bunch is found (collision data w/ bunch finder in the path)
       - if object doesn't exist (cosmic data and other cases w/o bunch finder)
    */
 
    if (m_recBunch.isValid()) {
      if (not m_recBunch->isReconstructed()) return;
    }
 
    TOPRecoManager::setDefaultTimeWindow();
    double timeMin = TOPRecoManager::getMinTime();
    double timeMax = TOPRecoManager::getMaxTime();
 
    // running offset must not be subtracted in TOPDigits: issue an error if it is
 
    if (isRunningOffsetSubtracted()) {
      B2ERROR("Running offset subtracted in TOPDigits: common T0 will not be correct");
    }
 
    // loop over reconstructed tracks, make a selection and accumulate log likelihoods
 
    for (const auto& track : m_tracks) {
 
      // track selection
      TOPTrack trk(track);
      if (not trk.isValid()) continue;
 
      if (not m_selector.isSelected(trk)) continue;
 
      // construct PDF
      PDFConstructor pdfConstructor(trk, m_selector.getChargedStable(), m_PDFOption);
      if (not pdfConstructor.isValid()) continue;
 
      // minimization procedure: accumulate
      int sub = gRandom->Integer(c_numSets); // generate sub-sample number
      auto& finder = m_finders[sub];
      const auto& binCenters = finder.getBinCenters();
      for (unsigned ibin = 0; ibin < binCenters.size(); ibin++) {
        double t0 = binCenters[ibin];
        finder.add(ibin, -2 * pdfConstructor.getLogL(t0, m_sigmaSmear).logL);
      }
 
      // fill histograms of hits
      m_numPhotons = 0;
      for (const auto& digit : m_digits) {
        if (digit.getHitQuality() != TOPDigit::c_Good) continue;
        if (digit.getModuleID() != trk.getModuleID()) continue;
        if (digit.getTime() < timeMin) continue;
        if (digit.getTime() > timeMax) continue;
        m_numPhotons++;
        m_hits1D.Fill(digit.getModuleID());
        int bs = digit.getBoardstackNumber();
        m_hits2D.Fill((digit.getModuleID() * 4 + bs - 1.5) / 4.0, digit.getTime());
      }
 
      // fill output tree
      m_moduleID = trk.getModuleID();
      const auto& localPosition = m_selector.getLocalPosition();
      m_x = localPosition.X();
      m_y = localPosition.Y();
      m_z = localPosition.Z();
      const auto& localMomentum = m_selector.getLocalMomentum();
      m_p = localMomentum.R();
      m_theta = localMomentum.Theta();
      m_phi = localMomentum.Phi();
      const auto& pocaPosition = m_selector.getPOCAPosition();
      m_pocaR = pocaPosition.Rho();
      m_pocaZ = pocaPosition.Z();
      m_pocaX = pocaPosition.X();
      m_pocaY = pocaPosition.Y();
      m_cmsE = m_selector.getCMSEnergy();
      m_charge = trk.getCharge();
      m_PDG = trk.getPDGCode();
      m_tree->Fill();
    }
 
  }

event() [9/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 103 of file TOPCosmicT0FinderModule.cc.

  {
    TOPRecoManager::setDefaultTimeWindow();
 
    // select track: if several, choose highest momentum track
 
    StoreArray<Track> tracks;
    const ExtHit* selectedExtHit = 0;
    double p0 = 0;
    for (const auto& track : tracks) {
      const auto extHits = track.getRelationsWith<ExtHit>();
      const ExtHit* extHit0 = 0;
      for (const auto& extHit : extHits) {
        if (abs(extHit.getPdgCode()) != Const::muon.getPDGCode()) continue;
        if (extHit.getDetectorID() != Const::EDetector::TOP) continue;
        if (extHit.getCopyID() <= 0) continue;
        double dot = extHit.getPosition().Dot(extHit.getMomentum());
        if (m_useIncomingTrack) {
          if (dot > 0) continue;
          if (not extHit0) extHit0 = &extHit;
          if (extHit.getTOF() < extHit0->getTOF()) extHit0 = &extHit;
        } else {
          if (dot < 0) continue;
          if (not extHit0) extHit0 = &extHit;
          if (extHit.getTOF() > extHit0->getTOF()) extHit0 = &extHit;
        }
      }
      if (not extHit0) continue;
      double p = extHit0->getMomentum().R();
      if (p > p0) {
        p0 = p;
        selectedExtHit = extHit0;
      }
    }
    if (not selectedExtHit) return;
 
    TOPTrack topTrack(selectedExtHit);
    if (not topTrack.isValid()) return;
 
    // require minimal number of photon hits
 
    if (topTrack.getSelectedHits().size() < m_minHits) return;
 
    // construct PDF for muon
 
    PDFConstructor pdfConstructor(topTrack, Const::muon, PDFConstructor::c_Rough);
    if (not pdfConstructor.isValid()) return;
 
    // require minimal expected signal
 
    if (pdfConstructor.getExpectedSignalPhotons() < m_minSignal) return;
 
    // event is accepted for t0 determination
 
    m_acceptedCount++;
 
    // full time window in which data are taken (smaller time window is used in reconstruction)
 
    const auto& tdc = TOPGeometryPar::Instance()->getGeometry()->getNominalTDC();
    double timeWindow = m_feSetting->getReadoutWindows() * tdc.getSyncTimeBase() / static_cast<double>(TOPNominalTDC::c_syncWindows);
 
    // find rough t0
 
    PDF1Dim pdf1d(pdfConstructor, 1.0, timeWindow);  // ~1 ns bin size
    pdfConstructor.switchOffDeltaRayPDF(); // to speed-up fine search
 
    Chi2MinimumFinder1D roughFinder(pdf1d.getNumBinsT0(), pdf1d.getMinT0(), pdf1d.getMaxT0());
    const auto& bins = roughFinder.getBinCenters();
    for (unsigned i = 0; i < bins.size(); i++) {
      double t0 = bins[i];
      roughFinder.add(i, -2 * pdf1d.getLogL(t0));
    }
    const auto& t0Rough = roughFinder.getMinimum();
 
    // find precise t0
 
    double timeMin = TOPRecoManager::getMinTime() + t0Rough.position;
    double timeMax = TOPRecoManager::getMaxTime() + t0Rough.position;
    double t0min = t0Rough.position - m_timeRange / 2;
    double t0max = t0Rough.position + m_timeRange / 2;
    Chi2MinimumFinder1D finder(m_numBins, t0min, t0max);
    const auto& binCenters = finder.getBinCenters();
    int numPhotons = 0;
    for (unsigned i = 0; i < binCenters.size(); i++) {
      double t0 = binCenters[i];
      auto LL = pdfConstructor.getLogL(t0, timeMin, timeMax, m_sigma);
      finder.add(i, -2 * LL.logL);
      if (i == 0) numPhotons = LL.numPhotons;
    }
    const auto& t0 = finder.getMinimum();
    if (t0.position < t0min or t0.position > t0max or not t0.valid) return; // out of range
 
    // event t0 is successfully determined
 
    m_successCount++;
 
    // store results
 
    StoreArray<TOPTimeZero> timeZeros;
    auto* timeZero = timeZeros.appendNew(topTrack.getModuleID(), t0.position, t0.error, numPhotons);
    timeZero->addRelationTo(topTrack.getTrack());
    timeZero->addRelationTo(topTrack.getExtHit());
    if (topTrack.getBarHit()) timeZero->addRelationTo(topTrack.getBarHit());
 
    // save histograms
 
    if (m_saveHistograms) {
      std::string name;
 
      name = "chi2_" + to_string(m_num);
      std::string title = "muon -2 logL vs. t0; t_{0} [ns]; -2 log L_{#mu}";
      auto chi2 = finder.getHistogram(name, title);
 
      name = "pdf_" + to_string(m_num);
      auto pdf = pdf1d.getHistogram(name, "PDF projected to time axis");
      pdf.SetName(name.c_str());
      pdf.SetXTitle("time [ns]");
      pdf.SetLineColor(2);
      pdf.SetOption("hist");
 
      name = "hits_" + to_string(m_num);
      TH1F hits(name.c_str(), "time distribution of photons (t0-subtracted)",
                pdf.GetNbinsX(), pdf.GetXaxis()->GetXmin(), pdf.GetXaxis()->GetXmax());
      hits.SetXTitle("time [ns]");
      for (const auto& hit : topTrack.getSelectedHits()) {
        hits.Fill(hit.time - t0.position);
      }
      timeZero->setHistograms(chi2, pdf, hits);
      m_num++;
    }
 
    // subtract T0 in digits
 
    if (m_applyT0) {
      StoreArray<TOPDigit> topDigits;
      for (auto& digit : topDigits) {
        digit.subtractT0(t0.position);
        double err = digit.getTimeError();
        digit.setTimeError(sqrt(err * err + t0.error * t0.error));
        digit.addStatus(TOPDigit::c_EventT0Subtracted);
      }
    }
 
  }

event() [10/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 237 of file TOPDigitizerModule.cc.

  {
 
    // get or generate revo9 count
    unsigned revo9cnt = 0;
    if (m_simClockState.isValid()) {
      revo9cnt = m_simClockState->getRevo9Count();
    } else {
      revo9cnt = gRandom->Integer(11520);
    }
 
    // from revo9 count determine trigger time offset and the number of offset windows
    double SSTfrac = (revo9cnt % 6) / 6.0;
    double offset = m_feSetting->getOffset() / 24.0;
    double trgTimeOffset = (SSTfrac + offset) * m_syncTimeBase;  // in [ns]
    int offsetWindows = m_feSetting->getWindowShift(revo9cnt);
    TimeDigitizer::setOffsetWindows(offsetWindows);
 
    // from revo9 and write depths determine reference window, phase and storage depth
    int SSTcnt = revo9cnt / 6;
    int refWindow = SSTcnt * 2;  // same as lastWriteAddr
    const auto& writeDepths = m_feSetting->getWriteDepths();
    if (writeDepths.empty()) {
      B2ERROR("TOPDigitzer: vector of write depths is empty. No digitization possible");
      return;
    }
    int lastDepth = writeDepths.back();
    unsigned phase = 0;
    for (auto depth : writeDepths) {
      SSTcnt -= depth;
      if (SSTcnt < 0) break;
      phase++;
      refWindow = SSTcnt * 2;
      lastDepth = depth;
    }
    unsigned storageDepth = lastDepth * 2;
    TimeDigitizer::setStorageDepth(storageDepth);
 
    // from reference window and lookback determine first of the readout windows
    int lookBackWindows = m_feSetting->getLookbackWindows();
    if (m_lookBackWindows > 0) lookBackWindows = m_lookBackWindows;
    lookBackWindows -= m_feSetting->getExtraWindows();
    int window = refWindow - lookBackWindows;
    if (window < 0) window += storageDepth;
    TimeDigitizer::setFirstWindow(window);
 
    // geometry and nominal data
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
 
    // time range for digitization
    double timeMin = geo->getSignalShape().getTMin() + offsetWindows * m_syncTimeBase / 2;
    double timeMax = geo->getSignalShape().getTMax() +
                     (m_feSetting->getReadoutWindows() + offsetWindows) * m_syncTimeBase / 2;
 
    // simulate start time jitter
    double startTimeJitter = gRandom->Gaus(0, m_timeZeroJitter);
 
    // get electronic efficiency
    double electronicEfficiency = geo->getNominalTDC().getEfficiency();
 
    // define pixels with time digitizers
    std::map<unsigned, TimeDigitizer> pixels;
    typedef std::map<unsigned, TimeDigitizer>::iterator Iterator;
 
    // add simulated hits to time digitizers
 
    for (const auto& simHit : m_simHits) {
      if (not m_useWaveforms) {
        // simulate electronic efficiency
        if (gRandom->Rndm() > electronicEfficiency) continue;
      }
      // do spatial digitization
      double x = simHit.getX();
      double y = simHit.getY();
      int pmtID = simHit.getPmtID();
      int moduleID = simHit.getModuleID();
      if (not geo->isModuleIDValid(moduleID)) continue;
      int pixelID = geo->getModule(moduleID).getPMTArray().getPixelID(x, y, pmtID);
      if (pixelID == 0) continue;
 
      // add start time jitter and generated TTS to photon time
      double time = simHit.getTime() + startTimeJitter;
      if (m_simulateTTS) {
        const auto& tts = TOPGeometryPar::Instance()->getTTS(moduleID, pmtID);
        time += tts.generateTTS();
      }
 
      // get time offset for a given pixel
      auto timeOffset = getTimeOffset(trgTimeOffset, moduleID, pixelID);
 
      // time range cut (to speed up digitization)
      if (time + timeOffset.value < timeMin + timeOffset.timeShift) continue;
      if (time + timeOffset.value > timeMax + timeOffset.timeShift) continue;
 
      // generate pulse height
      double pulseHeight = generatePulseHeight(moduleID, pixelID);
      auto hitType = TimeDigitizer::c_Hit;
 
      // add time and pulse height to digitizer of a given pixel
      TimeDigitizer digitizer(moduleID, pixelID, timeOffset.value, timeOffset.error,
                              timeOffset.windowShift, m_rmsNoise, m_sampleTimes);
      if (not digitizer.isValid()) continue;
      unsigned id = digitizer.getUniqueID();
      Iterator it = pixels.insert(pair<unsigned, TimeDigitizer>(id, digitizer)).first;
      it->second.addTimeOfHit(time, pulseHeight, hitType, &simHit);
    }
 
    // add calibration pulses
 
    for (const auto& simCalPulses : m_simCalPulses) {
      auto moduleID = simCalPulses.getModuleID();
      auto pixelID = simCalPulses.getPixelID();
      auto pulseHeight = simCalPulses.getAmplitude();
      auto time = simCalPulses.getTime();
      auto hitType = TimeDigitizer::c_CalPulse;
 
      // get time offset for a given pixel
      auto timeOffset = getTimeOffset(trgTimeOffset, moduleID, pixelID);
 
      // time range cut (to speed up digitization)
      if (time + timeOffset.value < timeMin + timeOffset.timeShift) continue;
      if (time + timeOffset.value > timeMax + timeOffset.timeShift) continue;
 
      // add time and pulse height to digitizer of a given pixel
      TimeDigitizer digitizer(moduleID, pixelID, timeOffset.value, timeOffset.error,
                              timeOffset.windowShift, m_rmsNoise, m_sampleTimes);
      if (not digitizer.isValid()) continue;
      unsigned id = digitizer.getUniqueID();
      Iterator it = pixels.insert(pair<unsigned, TimeDigitizer>(id, digitizer)).first;
      it->second.addTimeOfHit(time, pulseHeight, hitType);
    }
 
    // add randomly distributed dark noise (maybe not needed anymore?)
 
    if (m_darkNoise > 0) {
      int numModules = geo->getNumModules();
      for (int moduleID = 1; moduleID <= numModules; moduleID++) {
        int numPixels = geo->getModule(moduleID).getPMTArray().getNumPixels();
        int numHits = gRandom->Poisson(m_darkNoise);
        for (int i = 0; i < numHits; i++) {
          int pixelID = int(gRandom->Rndm() * numPixels) + 1;
          double time = (timeMax - timeMin) * gRandom->Rndm() + timeMin;
          double pulseHeight = generatePulseHeight(moduleID, pixelID);
          auto hitType = TimeDigitizer::c_Hit;
          auto timeOffset = getTimeOffset(trgTimeOffset, moduleID, pixelID);
          time += timeOffset.timeShift;
          time -= timeOffset.value;
          TimeDigitizer digitizer(moduleID, pixelID, timeOffset.value, timeOffset.error,
                                  timeOffset.windowShift, m_rmsNoise, m_sampleTimes);
          if (not digitizer.isValid()) continue;
          unsigned id = digitizer.getUniqueID();
          Iterator it = pixels.insert(pair<unsigned, TimeDigitizer>(id, digitizer)).first;
          it->second.addTimeOfHit(time, pulseHeight, hitType);
        }
      }
    }
 
    // if making waveforms for all channels, add missing digitizers.
 
    if (m_allChannels) {
      int numModules = geo->getNumModules();
      for (int moduleID = 1; moduleID <= numModules; moduleID++) {
        int numPixels = geo->getModule(moduleID).getPMTArray().getNumPixels();
        for (int pixelID = 1; pixelID <= numPixels; pixelID++) {
          auto timeOffset = getTimeOffset(trgTimeOffset, moduleID, pixelID);
          TimeDigitizer digitizer(moduleID, pixelID, timeOffset.value, timeOffset.error,
                                  timeOffset.windowShift, m_rmsNoise, m_sampleTimes);
          if (not digitizer.isValid()) continue;
          unsigned id = digitizer.getUniqueID();
          pixels.insert(pair<unsigned, TimeDigitizer>(id, digitizer));
        }
      }
    }
 
    // replace equidistant time base with calibrated one if available
 
    if (m_useDatabase or m_useSampleTimeCalibration) {
      for (auto& pixel : pixels) {
        auto& digitizer = pixel.second;
        const auto* sampleTimes = m_timebases->getSampleTimes(digitizer.getScrodID(),
                                                              digitizer.getChannel());
        if (not sampleTimes) continue;
        if (sampleTimes->isCalibrated()) digitizer.setSampleTimes(sampleTimes);
      }
    }
 
    // replace default noise level with channel dependent one if available,
 
    if (m_useDatabase) {
      for (auto& pixel : pixels) {
        auto& digitizer = pixel.second;
        auto moduleID = digitizer.getModuleID();
        auto channel = digitizer.getChannel();
        auto rmsNoise = m_noises->getNoise(moduleID, channel);
        if (rmsNoise > 0) {
          digitizer.setNoise(rmsNoise);
        }
      }
    }
 
    // digitize in time
 
    for (auto& pixel : pixels) {
      const auto& digitizer = pixel.second;
      int threshold = m_threshold;
      if (m_useDatabase) { // use channel dependent ones
        threshold = m_thresholds->getThr(digitizer.getModuleID(), digitizer.getChannel());
        if (threshold <= 0) threshold = m_threshold; // not available, use the default
      }
      if (m_useWaveforms) {
        digitizer.digitize(m_waveforms, m_rawDigits, m_digits,
                           threshold, m_hysteresis, m_thresholdCount);
      } else {
        digitizer.digitize(m_rawDigits, m_digits,
                           threshold, m_thresholdCount, m_electronicJitter);
      }
    }
 
    // set additional info
 
    for (auto& rawDigit : m_rawDigits) {
      rawDigit.setRevo9Counter(revo9cnt);
      rawDigit.setPhase(phase);
      rawDigit.setLastWriteAddr(refWindow);
      rawDigit.setLookBackWindows(lookBackWindows);
      rawDigit.setOfflineFlag();
    }
 
    for (auto& waveform : m_waveforms) {
      waveform.setRevo9Counter(revo9cnt);
      waveform.setOffsetWindows(offsetWindows);
    }
 
    // set calibration flags
 
    if (m_useDatabase) {
      for (auto& digit : m_digits) {
        if (m_channelT0->isCalibrated(digit.getModuleID(), digit.getChannel())) {
          digit.addStatus(TOPDigit::c_ChannelT0Calibrated);
        }
        if (m_moduleT0->isCalibrated(digit.getModuleID())) {
          digit.addStatus(TOPDigit::c_ModuleT0Calibrated);
        }
        if (m_commonT0->isCalibrated()) {
          digit.addStatus(TOPDigit::c_CommonT0Calibrated);
        }
      }
    }
 
    // cut on product of pulse width and height, as for data in TOPRawDigitConverter
 
    for (auto& digit : m_digits) {
      if (digit.getPulseWidth() * digit.getPulseHeight() < m_minWidthXheight)
        digit.setHitQuality(TOPDigit::c_Junk);
    }
 
  }

event() [11/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 90 of file TOPTriggerDigitizerModule.cc.

  {
 
    // input: simulated waveforms
    StoreArray<TOPRawWaveform> waveforms;
 
    // output: time stamps for trigger input
    StoreArray<TOPTriggerDigit> digits;
    StoreObjPtr<TOPTriggerMCInfo> mcInfo;
    mcInfo.create();
 
    if (waveforms.getEntries() == 0) {
      B2ERROR("No waveforms available for digitization");
      return;
    }
    unsigned revo9count = waveforms[0]->getRevo9Counter();
    int offsetSamples = waveforms[0]->getOffsetWindows() * TOPRawWaveform::c_WindowSize +
                        (revo9count % 6) * TOPRawWaveform::c_WindowSize / 3;
 
    int bunchTimeStamp = int((revo9count + gRandom->Rndm()) * static_cast<double>(c_SamplingCycle) / 3.0);
    mcInfo->setBunchTimeStamp(bunchTimeStamp);
 
    int offset = bunchTimeStamp - offsetSamples / c_SamplingCycle;
 
    for (const auto& waveform : waveforms) {
      const auto& data = waveform.getWaveform();
      int currentThr = m_threshold;
      bool lastState = false;
      int gate = 0;
      TOPTriggerDigit* digit = 0;
      for (int i = 0; i < (int) data.size(); i++) {
        gate--;
        if (data[i] > currentThr) {
          currentThr = m_threshold - m_hysteresis;
          if (!lastState) gate = m_gateWidth;
          lastState = true;
        } else {
          currentThr = m_threshold;
          lastState =  false;
        }
        if (i % c_SamplingCycle == m_samplingPhase and gate > 0) {
          if (i / c_SamplingCycle == 0) continue; // first time stamp is not correct
          if (!digit) {
            digit = digits.appendNew(waveform.getModuleID(),
                                     waveform.getChannel(),
                                     waveform.getScrodID());
            digit->addRelationTo(&waveform);
          }
          int timeStamp = i / c_SamplingCycle + offset;
          while (timeStamp < 0) {timeStamp += c_Frame9Period;};
          timeStamp = timeStamp % c_Frame9Period;
          digit->appendTimeStamp(timeStamp);
        }
      }
    }
 
  }

event() [12/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 101 of file TOPCalPulseGeneratorModule.cc.

  {
    const auto& chMapper = TOPGeometryPar::Instance()->getChannelMapper();
 
    double time = m_delay + gRandom->Uniform(m_windowSize);
    for (auto moduleID : m_moduleIDs) {
      for (unsigned asic = 0; asic < 64; asic++) {
        for (auto asicChannel : m_asicChannels) {
          unsigned channel = asic * 8 + asicChannel;
          auto pixelID = chMapper.getPixelID(channel);
          m_calPulses.appendNew(moduleID, channel, pixelID, time, m_amplitude);
        }
      }
    }
 
  }

event() [13/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 162 of file TOPDoublePulseGeneratorModule.cc.

  {
 
    StoreArray<TOPDigit> digits;
 
    const auto& chMapper = TOPGeometryPar::Instance()->getChannelMapper();
    const auto& feMapper = TOPGeometryPar::Instance()->getFrontEndMapper();
 
    double timeError = m_timeResolution / sqrt(2.0); // for single pulse
 
    for (auto moduleID : m_moduleIDs) {
      for (unsigned asic = 0; asic < 64; asic++) {
        for (auto asicChannel : m_asicChannels) {
          unsigned channel = asic * 8 + asicChannel;
          auto pixelID = chMapper.getPixelID(channel);
 
          // sample times: from steering or database
          const TOPSampleTimes* sampleTimes = &m_sampleTimes;
          if (m_useDatabase) {
            unsigned scrodID = 0;
            int bs = asic / 16;
            const auto* feMap = feMapper.getMap(moduleID, bs);
            if (feMap) scrodID = feMap->getScrodID();
            sampleTimes = (*m_timebase)->getSampleTimes(scrodID, channel % 128);
            if (!sampleTimes->isCalibrated()) {
              B2WARNING("No sample time calibration available for SCROD " << scrodID
                        << " channel " << channel % 128 << " - equidistant will be used");
            }
          }
 
          // first calpulse
          double time = gRandom->Rndm() * sampleTimes->getTimeRange();
          unsigned window = gRandom->Rndm() * m_storageWindows;
          double sample = sampleTimes->getSample(window, time);
          auto* digit = digits.appendNew(moduleID, pixelID, sample);
          digit->setFirstWindow(window);
          digit->setTime(time);
          digit->setTimeError(timeError);
          digit->setChannel(channel);
          digit->setHitQuality(TOPDigit::c_CalPulse);
 
          // second calpulse
          time += gRandom->Gaus(m_timeDifference, m_timeResolution);
          sample = sampleTimes->getSample(window, time);
          digit = digits.appendNew(moduleID, pixelID, sample);
          digit->setFirstWindow(window);
          digit->setTime(time);
          digit->setTimeError(timeError);
          digit->setChannel(channel);
          digit->setHitQuality(TOPDigit::c_CalPulse);
        }
      }
    }
 
  }

event() [14/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from HistoModule.

Definition at line 310 of file TOPDQMModule.cc.

  {
 
    // check if event time is reconstructed; distinguish collision data and cosmics
 
    bool recBunchValid = false;
    bool cosmics = false;
    if (m_recBunch.isValid()) { // collision data
      recBunchValid = m_recBunch->isReconstructed(); // event time is reconstructed
    } else if (m_timeZeros.getEntries() ==  1) { // cosmics w/ reconstructed event time
      cosmics = true;
      m_eventT0->Fill(m_timeZeros[0]->getTime());
    }
 
    // fill bunch offset
 
    if (recBunchValid) {
      double t0 = m_commonT0->isRoughlyCalibrated() ? m_commonT0->getT0() : 0;
      double offset = m_recBunch->getCurrentOffset() - t0;
      offset -= m_bunchTimeSep * lround(offset / m_bunchTimeSep); // wrap around
      m_bunchOffset->Fill(offset);
      m_eventT0->Fill(m_recBunch->getTime());
    }
 
    // fill event desynchronization
 
    if (m_digits.getEntries() > 0) {
      for (const auto& digit : m_digits) {
        int x = digit.getFirstWindow() != m_digits[0]->getFirstWindow() ? 1 : 0 ;
        m_BoolEvtMonitor->Fill(x);
      }
    }
 
    // count tracks in the modules and store the momenta
 
    std::vector<int> numTracks(m_numModules, 0);
    std::vector<double> trackMomenta(m_numModules, 0);
    for (const auto& track : m_tracks) {
      const auto* fitResult = track.getTrackFitResultWithClosestMass(Const::pion);
      if (not fitResult) continue;
      int slot = getModuleID(track);
      if (slot == 0) continue;
      numTracks[slot - 1]++;
      trackMomenta[slot - 1] = std::max(trackMomenta[slot - 1], fitResult->getMomentum().R());
    }
 
    // count events w/ and w/o track in the slot
 
    if (recBunchValid or cosmics) {
      for (size_t i = 0; i < numTracks.size(); i++) {
        bool hit = numTracks[i] > 0;
        m_trackHits->Fill(i + 1, hit);
      }
    }
 
    // select modules for counting hits in signal and background time windows
 
    std::vector<bool> selectedSlots(m_numModules, false);
    for (size_t i = 0; i < selectedSlots.size(); i++) {
      selectedSlots[i] = (recBunchValid or cosmics) and numTracks[i] == 1 and trackMomenta[i] > m_momentumCut;
    }
 
    // prepare counters
 
    int nHits_good = 0;
    int nHits_bad = 0;
    std::vector<int> numSignalHits(m_numModules, 0);
    std::vector<int> numBackgroundHits(m_numModules, 0);
 
    // loop over digits, fill histograms and increment counters
 
    for (const auto& digit : m_digits) {
      int slot = digit.getModuleID();
      if (slot < 1 or slot > m_numModules) {
        B2ERROR("Invalid slot ID found in TOPDigits: ID = " << slot);
        continue;
      }
      int asic_no = digit.getChannel() / 8;
      int asic_ch = digit.getChannel() % 8;
 
      m_window_vs_slot->Fill(digit.getModuleID(), digit.getRawTime() / 64 + 220);
      m_window_vs_asic[slot - 1]->Fill(asic_no, digit.getRawTime() / 64 + 220);
 
      if (digit.getHitQuality() != TOPDigit::c_Junk) { // good hits
        m_goodHitsXY[slot - 1]->Fill(digit.getPixelCol(), digit.getPixelRow());
        m_goodHitsAsics[slot - 1]->Fill(asic_no, asic_ch);
        m_goodTDC[slot - 1]->Fill(digit.getRawTime());
        m_goodTDCAll->Fill(digit.getRawTime());
        m_goodChannelHits[slot - 1]->Fill(digit.getChannel());
        m_pulseHeights[slot - 1]->Fill(digit.getPMTNumber(), digit.getPulseHeight());
        nHits_good++;
        if (digit.hasStatus(TOPDigit::c_EventT0Subtracted)) {
          double time = digit.getTime();
          if (cosmics) time += 10; // move for 10 ns in order to get the complete signal at positive times
          if (numTracks[slot - 1] > 0) {
            m_goodTiming[slot - 1]->Fill(time);
            m_time->Fill(time);
          } else {
            m_goodTimingBG[slot - 1]->Fill(time);
            m_timeBG->Fill(time);
          }
          if (selectedSlots[slot - 1] and abs(time) < 50) {
            if (time > 0) numSignalHits[slot - 1]++;
            else numBackgroundHits[slot - 1]++;
          }
        }
      } else { // bad hits: FE not valid, pedestal jump, too short or too wide pulses
        m_badHitsXY[slot - 1]->Fill(digit.getPixelCol(), digit.getPixelRow());
        m_badHitsAsics[slot - 1]->Fill(asic_no, asic_ch);
        m_badTDC[slot - 1]->Fill(digit.getRawTime());
        m_badTDCAll->Fill(digit.getRawTime());
        m_badChannelHits[slot - 1]->Fill(digit.getChannel());
        nHits_bad++;
      }
    }
 
    // histogram counters
 
    m_goodHitsPerEventAll->Fill(nHits_good);
    m_badHitsPerEventAll->Fill(nHits_bad);
    for (int slot = 1; slot <= m_numModules; slot++) {
      if (selectedSlots[slot - 1]) {
        m_signalHits->Fill(slot, numSignalHits[slot - 1]);
        m_backgroundHits->Fill(slot, numBackgroundHits[slot - 1]);
      }
    }
 
    // fill injection histograms
 
    for (auto& it : m_rawFTSW) {
      B2DEBUG(29, "TTD FTSW : " << hex << it.GetTTUtime(0) << " " << it.GetTTCtime(0) << " EvtNr " << it.GetEveNo(0)  << " Type " <<
              (it.GetTTCtimeTRGType(0) & 0xF) << " TimeSincePrev " << it.GetTimeSincePrevTrigger(0) << " TimeSinceInj " <<
              it.GetTimeSinceLastInjection(0) << " IsHER " << it.GetIsHER(0) << " Bunch " << it.GetBunchNumber(0));
      auto difference = it.GetTimeSinceLastInjection(0);
      if (difference != 0x7FFFFFFF) {
        unsigned int nentries = m_digits.getEntries();
        float diff2 = difference / 127.; //  127MHz clock ticks to us, inexact rounding
        if (it.GetIsHER(0)) {
          m_TOPOccAfterInjHER->Fill(diff2, nentries);
          m_TOPEOccAfterInjHER->Fill(diff2);
        } else {
          m_TOPOccAfterInjLER->Fill(diff2, nentries);
          m_TOPEOccAfterInjLER->Fill(diff2);
        }
      }
    }
 
  }

event() [15/32]

void event ( void  )

overridevirtual

This will be empty as the all the processes are done in beginRun() function thus input file can be a dummy file.

Reimplemented from HistoModule.

Definition at line 164 of file TOPGainEfficiencyCalculatorModule.cc.

  {
  }

event() [16/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from HistoModule.

Definition at line 154 of file TOPLaserHitSelectorModule.cc.

  {
    StoreArray<TOPDigit> digits;
 
    std::map<short, float> refTimingMap;//map of pixel id and time
    std::map<short, std::vector<hitInfo_t> >
    calPulsesMap;//map of pixel id and hit information (timing and pulse charge) for cal. pulse candidetes
 
    //first, identify cal. pulse
    for (const auto& digit : digits) {
 
      short slotId = digit.getModuleID();
      short pixelId = digit.getPixelID();
      short globalPixelId = (slotId - 1) * c_NPixelPerModule + pixelId - 1;
      if (digit.getHitQuality() == TOPDigit::c_CalPulse) {
        calPulsesMap[globalPixelId].push_back((hitInfo_t) { (float)digit.getTime(), (float)digit.getPulseHeight() });
      }
    }// for digit pair
 
 
    //cal. pulse timing calculation
    for (const auto& calPulse : calPulsesMap) {
 
      short globalPixelId = calPulse.first;
      short globalAsicId = globalPixelId / c_NChannelPerAsic;
      std::vector<hitInfo_t> vec = calPulse.second;
      double calPulseTiming = 9999999;
      unsigned nCalPulseCandidates = vec.size();
      if (!m_useDoublePulse) { //try to find the first cal. pulse in case that both of double cal. pulses are not required (choose the largest hit)
        double maxPulseHeight = -1;
        double maxHeightTiming = 9999999;
        for (unsigned iVec = 0 ; iVec < nCalPulseCandidates ; iVec++) {
          if (maxPulseHeight < vec[iVec].m_height) {
            maxPulseHeight = vec[iVec].m_height;
            maxHeightTiming = vec[iVec].m_time;
          }
        }
        if (maxPulseHeight > m_calibrationPulseThreshold1)
          calPulseTiming = maxHeightTiming;
      } else { //try to identify both of double cal. pulses when specified by option (default)
        for (unsigned iVec = 0 ; iVec < nCalPulseCandidates ; iVec++) {
          for (unsigned jVec = 0 ; jVec < nCalPulseCandidates ; jVec++) {
 
            if (iVec == jVec || vec[iVec].m_time > vec[jVec].m_time) continue;
            if (vec[iVec].m_height > m_calibrationPulseThreshold1
                && vec[jVec].m_height > m_calibrationPulseThreshold2
                && TMath::Abs(vec[jVec].m_time - vec[iVec].m_time - m_calibrationPulseInterval) < m_calibrationPulseIntervalRange) {
 
              //in case multiple candidates of double cal. pulses are found,
              //choose a pair with the earliest 1st cal. pulse timing
              if (refTimingMap.count(globalAsicId) == 0 || refTimingMap[globalAsicId] > vec[iVec].m_time)
                calPulseTiming = vec[iVec].m_time;
            }
          }//for(jVec)
        }//for(iVec)
      }//if(m_useDoublePulse)
 
      if (calPulseTiming < 9999998) { //when cal. pulse(s) are properly identified
        refTimingMap[globalAsicId] = calPulseTiming;
        m_nCalPulseHistogram->Fill(globalAsicId);
      }
    }//for(pair)
 
    //calculate hit timing with respect to cal. pulse and fill hit info. histogram
    for (const auto& digit : digits) {
      short slotId = digit.getModuleID();
      short pixelId = digit.getPixelID();
      short globalPixelId = (slotId - 1) * c_NPixelPerModule + pixelId - 1;
      short globalAsicId = globalPixelId / c_NChannelPerAsic;
 
      if (digit.getHitQuality() == TOPDigit::c_Junk
          || digit.getHitQuality() == TOPDigit::c_CrossTalk) continue;
 
      float hitTime = digit.getTime() - refTimingMap[globalAsicId];
      float pulseHeight = digit.getPulseHeight();
      float Integral = digit.getIntegral();
      short windowNumberOfHit = (short)(digit.getFirstWindow()) + (short)(digit.getRawTime() / 64);
      if (m_windowSelect && windowNumberOfHit % 2 != (m_windowSelect - 1)) continue;
 
      if (m_includeAllChargeShare) {
        m_TimeHeightHistogramForHitRate[globalPixelId]->Fill(hitTime, pulseHeight);
        m_TimeIntegralHistogramForFit[globalPixelId]->Fill(hitTime, Integral);
        m_TimeHeightHistogramForFit[globalPixelId]->Fill(hitTime, pulseHeight);
        continue;
      }
 
      if (!digit.isSecondaryChargeShare()) {
        m_TimeHeightHistogramForHitRate[globalPixelId]->Fill(hitTime, pulseHeight);
        if (m_includePrimaryChargeShare) {
          m_TimeIntegralHistogramForFit[globalPixelId]->Fill(hitTime, Integral);
          m_TimeHeightHistogramForFit[globalPixelId]->Fill(hitTime, pulseHeight);
          continue;
        }
      }
 
      if (digit.isSecondaryChargeShare() || digit.isPrimaryChargeShare()) continue;
      m_TimeIntegralHistogramForFit[globalPixelId]->Fill(hitTime, Integral);
      m_TimeHeightHistogramForFit[globalPixelId]->Fill(hitTime, pulseHeight);
    }
 
  }

event() [17/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from HistoModule.

Definition at line 163 of file TOPInterimFENtupleModule.cc.

  {
 
    m_nHit = 0;
    m_nFEHeader = 0;
    m_nEmptyFEHeader = 0;
    m_nWaveform = 0;
    m_errorFlag = 0;
 
    StoreObjPtr<EventMetaData> EventMetaDataPtr;
    StoreArray<RawTOP> rawTOPs;
    StoreArray<TOPDigit> digits;
 
    for (int iSlot = 0 ; iSlot < c_NModule ; iSlot++) {
      m_eventNumCopper[iSlot] = -1;
      m_ttuTime[iSlot] = -1;
      m_ttcTime[iSlot] = -1;
    }
    int iSlotTTC = 0;
    short trigCtime = -1;
    for (auto& rawTOP : rawTOPs) {
      if (iSlotTTC >= c_NModule) {
        B2WARNING("too many TTC information");
        break;
      }
      m_eventNumCopper[iSlotTTC] = rawTOP.GetEveNo(0);
      m_ttuTime[iSlotTTC] = rawTOP.GetTTUtime(0);
      m_ttcTime[iSlotTTC] = rawTOP.GetTTCtime(0);
 
      if (trigCtime < 0)
        trigCtime = ((((long)m_ttcTime[iSlotTTC] + (long)(m_ttuTime[iSlotTTC] - 1524741300) * 127216000) % 11520) % 3840) % 1284;
      iSlotTTC++;
    }
 
    std::map<short, short> nHitOfflineFEMap;
    static std::set<short> noisyChannelBlackListSet;
    UInt_t EventNum = EventMetaDataPtr->getEvent();
    m_eventNum = EventNum;
    m_eventErrorFlag = EventMetaDataPtr->getErrorFlag();
    for (const auto& digit : digits) {
 
      if (m_nHit >= c_NMaxHitEvent) {
        B2WARNING("TOPInterimFENtuple : too many hits found (>=" << c_NMaxHitEvent
                  << "), EventNo = " << EventNum << ", no more hits are recorded.");
        break;
      }
 
      m_slotNum[m_nHit] = digit.getModuleID();
      m_pixelId[m_nHit] = (short)digit.getPixelID();
      m_channelId[m_nHit] = (short)digit.getChannel();
      m_isCalCh[m_nHit] = (digit.getASICChannel() == m_calibrationChannel);
      m_winNum[m_nHit] = -1;
      m_eventWinNum[m_nHit] = (short)digit.getFirstWindow();
      m_trigWinNum[m_nHit] = trigCtime;
      m_revo9Counter[m_nHit] = -1;
      m_hitQuality[m_nHit] = (unsigned char)digit.getHitQuality();
      m_isReallyJunk[m_nHit] = false;
      m_windowsInOrder[m_nHit] = true;
      m_rawTime[m_nHit] = digit.getRawTime();
      m_time[m_nHit] = digit.getTime() + m_winNum[m_nHit] * m_timePerWin;
      m_sample[m_nHit] = TMath::FloorNint(m_rawTime[m_nHit] + m_winNum[m_nHit] * c_NSamplePerWindow) % c_NSampleTBC;
      m_height[m_nHit] = digit.getPulseHeight();
      m_integral[m_nHit] = digit.getIntegral();
      m_width[m_nHit] = digit.getPulseWidth();
      m_peakSample[m_nHit] = -1;
      for (int iWindow = 0 ; iWindow < c_NWindow ; iWindow++)
        m_winNumList[m_nHit][iWindow] = -32767;
      for (int iSample = 0 ; iSample < c_NWaveformSample ; iSample++)
        m_waveform[m_nHit][iSample] = -32767;
      m_waveformStartSample[m_nHit] = -1;
 
      short globalChannelId = m_pixelId[m_nHit] - 1 + (m_slotNum[m_nHit] - 1) * c_NPixelPerModule;
      if (nHitOfflineFEMap.count(globalChannelId) == 0) nHitOfflineFEMap[globalChannelId] = 0;
      else if (nHitOfflineFEMap[globalChannelId] > c_NMaxHitPerChannel) {
        if (noisyChannelBlackListSet.count(globalChannelId) == 0) {
          // cppcheck-suppress stlFindInsert
          noisyChannelBlackListSet.insert(globalChannelId);
          B2WARNING("TOPInterimFENtuple : noisy channel with too many hits (slotNum="
                    << (globalChannelId / c_NPixelPerModule + 1) << ", pixelId = "
                    << (globalChannelId / c_NPixelPerModule + 1) << ") ");
        }
        continue;
      }
 
      const auto* rawDigit = digit.getRelated<TOPRawDigit>();
      if (rawDigit) {
        m_winNum[m_nHit] = rawDigit->getASICWindow();
        m_revo9Counter[m_nHit] = rawDigit->getRevo9Counter();
        m_peakSample[m_nHit] = rawDigit->getSamplePeak();
        m_windowsInOrder[m_nHit] = rawDigit->areWindowsInOrder();
        if (rawDigit->getDataType() == TOPRawDigit::c_Interim)
          m_trigWinNum[m_nHit] = (short)rawDigit->getLastWriteAddr();
        if (rawDigit->isPedestalJump()) m_isReallyJunk[m_nHit] = true;
        const auto* waveform = rawDigit->getRelated<TOPRawWaveform>();
        if (waveform) {
          if (rawDigit->isMadeOffline()) {
 
            //fill hit flags ; =1 : first hit from offline FE, =2 : second ... , =0 : online FE, -1 : no waveform
            nHitOfflineFEMap[globalChannelId]++;
            m_offlineFlag[m_nHit] = nHitOfflineFEMap[globalChannelId];
          } else { //hit from online feature extraction
            m_offlineFlag[m_nHit] = 0;
 
            //store waveform data
            unsigned nSampleWfm = waveform->getSize();
            unsigned nSample = TMath::Min((UShort_t)nSampleWfm, (UShort_t)c_NWaveformSample);
            if (nSample > c_NWaveformSample)
              B2WARNING("TOPInterimFENtuple: too many waveform samples in TOPRawWaveform : " << nSampleWfm << ", only first " << nSample <<
                        " are considered.");
            for (unsigned iSample = 0 ; iSample < nSample ; iSample++)
              m_waveform[m_nHit][iSample] = waveform->getWaveform()[iSample];
            m_waveformStartSample[m_nHit] = (short)waveform->getStartSample();
            m_nWaveformSample[m_nHit] = nSampleWfm;
            //store window number
            int iWin = 0;
            for (const auto& window : waveform->getStorageWindows()) {
              if (iWin < c_NWindow)
                m_winNumList[m_nHit][iWin] = window;
              else
                B2WARNING("TOPInterimFENtuple: too many windows were found");
 
              iWin++;
            }
 
          }
        }//if( waveform )
        else m_offlineFlag[m_nHit] = -1;
      } else {
        B2WARNING("TOPInterimFENtuple : no TOPRawDigit object found!");
        m_offlineFlag[m_nHit] = -100;
      }//if( rawDigit )
 
 
      m_nHit++;
    }//for( const auto& digit : digits )
 
    for (int iHit = 0 ; iHit < m_nHit ; iHit++) {
 
      short globalChannelId = m_pixelId[iHit] - 1 + (m_slotNum[iHit] - 1) * c_NPixelPerModule;
      m_nHitOfflineFE[iHit] = nHitOfflineFEMap[globalChannelId];
 
    }//for(int iHit)
 
    StoreArray<TOPInterimFEInfo> infos;
    for (const auto& info : infos) {
      m_nFEHeader += info.getFEHeadersCount();
      m_nEmptyFEHeader += info.getEmptyFEHeadersCount();
      m_nWaveform += info.getWaveformsCount();
      m_errorFlag |= info.getErrorFlags();
    }
 
    StoreArray<TOPProductionEventDebug> prodDebugs;
    m_nDebugInfo = 0;
    for (const auto& prodDebug : prodDebugs) {
      m_scrodCtime[m_nDebugInfo] = prodDebug.getCtime();
      m_phase[m_nDebugInfo] = prodDebug.getPhase();
      m_asicMask[m_nDebugInfo] = prodDebug.getAsicMask();
      m_eventQueuDepth[m_nDebugInfo] = prodDebug.getEventQueueDepth();
      m_eventNumberByte[m_nDebugInfo] = prodDebug.getEventNumberByte();
      m_nDebugInfo++;
    }
 
    //identify cal. pulse timing
    getReferenceTiming();
 
    m_tree->Fill();
  }

event() [18/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 85 of file TOPLaserCalibratorModule.cc.

  {
    for (auto& digit : m_digits) {
      if (m_barID != 0 && digit.getModuleID() != m_barID) continue; //if m_barID == 0, use all 16 slots(for MC test)
      unsigned channel = digit.getChannel();
      if (channel < c_NumChannels) {
        auto histo = m_histo[channel];
        if (!histo) {
          stringstream ss;
          ss << "chan" << channel ;
          string name;
          ss >> name;
          string title = "Times " + name;
          histo = new TH1F(name.c_str(), title.c_str(), (int)m_fitRange[0], m_fitRange[1], m_fitRange[2]);
          m_histo[channel] = histo;
        }
        if (digit.getHitQuality() != TOPDigit::EHitQuality::c_Good) continue;
        if (digit.getTime() < m_fitRange[1] || digit.getTime() > m_fitRange[2]) continue;
        if (!digit.isTimeBaseCalibrated()) continue;
        histo->Fill(digit.getTime()); //get Time from TOPDigit
      }
    }
  }

event() [19/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 92 of file TOPMCTrackMakerModule.cc.

  {
 
    StoreArray<MCParticle> mcParticles;
    StoreArray<TOPBarHit> barHits;
 
    StoreArray<Track> tracks;
    StoreArray<TrackFitResult> fitResults;
    StoreArray<ExtHit> extHits;
 
    for (const auto& mcParticle : mcParticles) {
      if (mcParticle.getStatus(MCParticle::c_PrimaryParticle) == 0) continue;
      if (mcParticle.getCharge() == 0) continue;
      const auto* barHit = mcParticle.getRelated<TOPBarHit>();
      if (!barHit) continue;
 
      TMatrixDSym cov(6); // infinite precission
      fitResults.appendNew(mcParticle.getVertex(),
                           mcParticle.getMomentum(),
                           cov,
                           mcParticle.getCharge(),
                           Const::pion,
                           1.0,            // pValue
                           BFieldManager::getField(0, 0, 0).Z() / Unit::T,
                           0x38FFFFFFFFFFFFFF, // 56 hits, in all CDC layers
                           0, 56 - 5); // NDF = 56-5
      auto* track = tracks.appendNew();
      track->setTrackFitResultIndex(Const::pion, fitResults.getEntries() - 1);
      track->addRelationTo(&mcParticle);
 
      const Const::ChargedStable& chargedStable = Const::pion;
      double pmom = barHit->getMomentum().R();
      double mass = chargedStable.getMass();
      double beta = pmom / sqrt(pmom * pmom + mass * mass);
      double tof = barHit->getLength() / beta / Const::speedOfLight;
      auto* extHit = extHits.appendNew(chargedStable.getPDGCode(),
                                       Const::TOP,
                                       barHit->getModuleID(),
                                       EXT_ENTER,
                                       false,
                                       tof,
                                       barHit->getPosition(),
                                       barHit->getMomentum(),
                                       cov);
      track->addRelationTo(extHit);
    }
 
  }

event() [20/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 169 of file TOPModuleT0CalibratorModule.cc.

  {
    /* check bunch reconstruction status and run alignment:
       - if object exists and bunch is found (collision data w/ bunch finder in the path)
       - if object doesn't exist (cosmic data and other cases w/o bunch finder)
    */
 
    if (m_recBunch.isValid()) {
      if (not m_recBunch->isReconstructed()) return;
    }
 
    TOPRecoManager::setDefaultTimeWindow();
    double timeMin = TOPRecoManager::getMinTime();
    double timeMax = TOPRecoManager::getMaxTime();
 
    // running offset must not be subtracted in TOPDigits: issue an error if it is
 
    if (isRunningOffsetSubtracted()) {
      B2ERROR("Running offset subtracted in TOPDigits: module T0 will not be correct");
    }
 
    // loop over reconstructed tracks, make a selection and accumulate log likelihoods
 
    for (const auto& track : m_tracks) {
 
      // track selection
      TOPTrack trk(track);
      if (not trk.isValid()) continue;
 
      if (not m_selector.isSelected(trk)) continue;
 
      // construct PDF
      PDFConstructor pdfConstructor(trk, m_selector.getChargedStable(), m_PDFOption);
      if (not pdfConstructor.isValid()) continue;
 
      // minimization procedure: accumulate
      const unsigned module = trk.getModuleID() - 1;
      if (module >= c_numModules) continue;
      int sub = gRandom->Integer(2); // generate sub-sample number
      auto& finder = m_finders[sub][module];
      const auto& binCenters = finder.getBinCenters();
      for (unsigned ibin = 0; ibin < binCenters.size(); ibin++) {
        double t0 = binCenters[ibin];
        finder.add(ibin, -2 * pdfConstructor.getLogL(t0, m_sigmaSmear).logL);
      }
 
      // fill histograms of hits
      m_numPhotons = 0;
      for (const auto& digit : m_digits) {
        if (digit.getHitQuality() != TOPDigit::c_Good) continue;
        if (digit.getModuleID() != trk.getModuleID()) continue;
        if (digit.getTime() < timeMin) continue;
        if (digit.getTime() > timeMax) continue;
        m_numPhotons++;
        m_hits1D.Fill(digit.getModuleID());
        int bs = digit.getBoardstackNumber();
        m_hits2D.Fill((digit.getModuleID() * 4 + bs - 1.5) / 4.0, digit.getTime());
      }
 
      // fill output tree
      m_moduleID = trk.getModuleID();
      const auto& localPosition = m_selector.getLocalPosition();
      m_x = localPosition.X();
      m_y = localPosition.Y();
      m_z = localPosition.Z();
      const auto& localMomentum = m_selector.getLocalMomentum();
      m_p = localMomentum.R();
      m_theta = localMomentum.Theta();
      m_phi = localMomentum.Phi();
      const auto& pocaPosition = m_selector.getPOCAPosition();
      m_pocaR = pocaPosition.Rho();
      m_pocaZ = pocaPosition.Z();
      m_pocaX = pocaPosition.X();
      m_pocaY = pocaPosition.Y();
      m_cmsE = m_selector.getCMSEnergy();
      m_charge = trk.getCharge();
      m_PDG = trk.getPDGCode();
      m_tree->Fill();
    }
 
  }

event() [21/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 131 of file TOPNtupleModule.cc.

  {
 
    StoreObjPtr<EventMetaData> evtMetaData;
    StoreArray<Track> tracks;
    StoreObjPtr<MCInitialParticles> mcInitialParticles;
    double trueEventT0 = 0;
    if (mcInitialParticles.isValid()) trueEventT0 = mcInitialParticles->getTime();
 
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
 
    for (const auto& track : tracks) {
      const auto* trackFit = track.getTrackFitResultWithClosestMass(Const::pion);
      if (!trackFit) continue;
      const TOPLikelihood* top = track.getRelated<TOPLikelihood>();
      if (!top) continue;
      if (top->getFlag() != 1) continue;
 
      const ExtHit* extHit = top->getRelated<ExtHit>();
      const TOPBarHit* barHit = top->getRelated<TOPBarHit>();
      const MCParticle* mcParticle = track.getRelated<MCParticle>();
      const MCParticle* mother = 0;
      if (mcParticle) {
        mother = mcParticle->getMother();
        if (not barHit) { // Track MC matching probably done after TOPReconstructor so no relation from TOPLikelihood
          const auto barHits = mcParticle->getRelationsWith<TOPBarHit>();
          for (const auto& bHit : barHits) {
            if (bHit.getModuleID() == extHit->getCopyID()) barHit = &bHit;
          }
        }
      }
 
      m_top.clear();
 
      m_top.evt = evtMetaData->getEvent();
      m_top.run = evtMetaData->getRun();
 
      ROOT::Math::XYZVector mom = trackFit->getMomentum();
      m_top.p = mom.R();
      m_top.cth = cos(mom.Theta());
      m_top.phi = mom.Phi();
      m_top.pValue = trackFit->getPValue();
 
      if (mcParticle) {
        m_top.PDG = mcParticle->getPDG();
        if (mother) m_top.motherPDG = mother->getPDG();
        m_top.primary = mcParticle->getStatus(MCParticle::c_PrimaryParticle);
        m_top.seen = mcParticle->hasSeenInDetector(Const::TOP);
        ROOT::Math::XYZVector prodVertex = mcParticle->getProductionVertex();
        m_top.rhoProd = prodVertex.Rho();
        m_top.zProd = prodVertex.Z();
        m_top.phiProd = prodVertex.Phi();
        ROOT::Math::XYZVector decVertex = mcParticle->getDecayVertex();
        m_top.rhoDec = decVertex.Rho();
        m_top.zDec = decVertex.Z();
        m_top.phiDec = decVertex.Phi();
        const auto digits = mcParticle->getRelationsWith<TOPDigit>();
        for (size_t i = 0; i < digits.size(); i++) {
          double wt = digits.weight(i);
          if (wt <= 0) continue; // photon not from this MC particle
          const auto* digit = digits[i];
          if (digit->getHitQuality() != TOPDigit::c_Good) continue;
          if (digit->getModuleID() != top->getModuleID()) continue;
          if (digit->getTime() < TOPRecoManager::getMinTime() or digit->getTime() > TOPRecoManager::getMaxTime()) continue;
          m_top.yieldMC++;
        }
      }
 
      m_top.numPhot = top->getNphot();
      m_top.numBkg = top->getEstBkg();
      m_top.moduleID = top->getModuleID();
 
      m_top.phot.e  = top->getEstPhot(Const::electron);
      m_top.phot.mu = top->getEstPhot(Const::muon);
      m_top.phot.pi = top->getEstPhot(Const::pion);
      m_top.phot.K  =  top->getEstPhot(Const::kaon);
      m_top.phot.p  = top->getEstPhot(Const::proton);
      m_top.phot.d  = top->getEstPhot(Const::deuteron);
 
      m_top.yield.e  = top->getEffectiveSignalYield(Const::electron);
      m_top.yield.mu = top->getEffectiveSignalYield(Const::muon);
      m_top.yield.pi = top->getEffectiveSignalYield(Const::pion);
      m_top.yield.K  =  top->getEffectiveSignalYield(Const::kaon);
      m_top.yield.p  = top->getEffectiveSignalYield(Const::proton);
      m_top.yield.d  = top->getEffectiveSignalYield(Const::deuteron);
 
      m_top.logL.e  = top->getLogL(Const::electron);
      m_top.logL.mu = top->getLogL(Const::muon);
      m_top.logL.pi = top->getLogL(Const::pion);
      m_top.logL.K  = top->getLogL(Const::kaon);
      m_top.logL.p  = top->getLogL(Const::proton);
      m_top.logL.d  = top->getLogL(Const::deuteron);
 
      if (extHit) {
        int moduleID = extHit->getCopyID();
        auto position = static_cast<ROOT::Math::XYZPoint>(extHit->getPosition());
        auto momentum = extHit->getMomentum();
        if (geo->isModuleIDValid(moduleID)) {
          const auto& module = geo->getModule(moduleID);
          position = module.pointToLocal(position);
          momentum = module.momentumToLocal(momentum);
        }
        m_top.extHit.moduleID = moduleID;
        m_top.extHit.PDG = extHit->getPdgCode();
        m_top.extHit.x = position.X();
        m_top.extHit.y = position.Y();
        m_top.extHit.z = position.Z();
        m_top.extHit.p = momentum.R();
        m_top.extHit.theta = momentum.Theta();
        m_top.extHit.phi = momentum.Phi();
        m_top.extHit.time = extHit->getTOF();
      }
 
      if (barHit) {
        int moduleID = barHit->getModuleID();
        auto position = barHit->getPosition();
        auto momentum = barHit->getMomentum();
        if (geo->isModuleIDValid(moduleID)) {
          const auto& module = geo->getModule(moduleID);
          position = module.pointToLocal(position);
          momentum = module.momentumToLocal(momentum);
        }
        m_top.barHit.moduleID = moduleID;
        m_top.barHit.PDG = barHit->getPDG();
        m_top.barHit.x = position.X();
        m_top.barHit.y = position.Y();
        m_top.barHit.z = position.Z();
        m_top.barHit.p = momentum.R();
        m_top.barHit.theta = momentum.Theta();
        m_top.barHit.phi = momentum.Phi();
        m_top.barHit.time = barHit->getTime() - trueEventT0;
      }
 
      m_tree->Fill();
    }
 
  }

event() [22/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 103 of file TOPPackerModule.cc.

  {
 
    switch (m_dataType) {
      case TOP::RawDataType::c_Type0Ver16:
        packType0Ver16();
        break;
      case TOP::RawDataType::c_ProductionDebug01:
        packProductionDebug();
        break;
      case TOP::RawDataType::c_Draft:
        packProductionDraft();
        break;
      default:
        B2ERROR("TOPPacker: data format unknown or not implemented");
    }
 
  }

event() [23/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from HistoModule.

Definition at line 118 of file TOPPDFCheckerModule.cc.

  {
    TOPRecoManager::setTimeWindow(m_minTime, m_maxTime);
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
 
    // loop over reconstructed tracks, call reconstruction and fill histograms
 
    int numTrk = 0;
    for (const auto& track : m_tracks) {
      TOPTrack trk(track);
      if (not trk.isValid()) continue;
      if (not trk.getMCParticle()) continue;
      if (not trk.getBarHit()) continue;
 
      auto chargedStable = Const::chargedStableSet.find(abs(trk.getPDGCode()));
      if (chargedStable == Const::invalidParticle) continue;
 
      PDFConstructor pdfConstructor(trk, chargedStable, PDFConstructor::c_Fine);
      if (not pdfConstructor.isValid()) continue;
      numTrk++;
 
      // average values - to print in terminate()
      const auto& module = geo->getModule(trk.getModuleID());
      m_avrgMomentum += module.momentumToLocal(trk.getExtHit()->getMomentum());
      m_avrgPosition += static_cast<XYZVector>(module.pointToLocal(static_cast<XYZPoint>(trk.getExtHit()->getPosition())));
      m_numTracks++;
      m_slotIDs.emplace(trk.getModuleID());
      m_PDGCodes.emplace(trk.getPDGCode());
 
      // histogram photons in a slot crossed by the track
      for (const auto& digit : m_digits) {
        if (digit.getModuleID() == trk.getModuleID() and digit.getTime() < m_maxTime) {
          if (not isFromThisParticle(digit, trk.getMCParticle())) continue;
          m_hits->Fill(digit.getPixelID(), digit.getTime());
          m_hitsCol->Fill(digit.getPixelCol(), digit.getTime());
        }
      }
 
      // histogram PDF using MC approach
      for (const auto& signalPDF : pdfConstructor.getSignalPDF()) {
        int pixelID = signalPDF.getPixelID();
        for (const auto& peak : signalPDF.getPDFPeaks()) {
          double numPhot = pdfConstructor.getExpectedSignalPhotons() * peak.nph;
          double sigma = sqrt(peak.wid);
          for (int i = 0; i < gRandom->Poisson(numPhot); i++) {
            double time = gRandom->Gaus(peak.t0, sigma);
            m_pdf->Fill(pixelID, time);
            int pixelCol = (pixelID - 1) % 64 + 1;
            m_pdfCol->Fill(pixelCol, time);
          }
        }
      }
 
    }
 
    if (numTrk == 0) {
      B2WARNING("No track hitting the bars");
    } else if (numTrk > 1) {
      B2WARNING("More than one track hits the bars");
    }
 
  }

event() [24/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 121 of file TOPPDFDebuggerModule.cc.

  {
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    TOPRecoManager::setTimeWindow(m_minTime, m_maxTime);
 
    // reconstruct track-by-track and store the results
 
    for (const auto& track : m_tracks) {
      TOPTrack trk(track);
      if (not trk.isValid()) continue;
 
      // add this vector of vector of triplets to the TOPPDFCollection
      TOPPDFCollection* topPDFColl = m_pdfCollection.appendNew();
      const auto& module = geo->getModule(trk.getModuleID());
      topPDFColl->setLocalPositionMomentum(module.pointToLocal(static_cast<XYZPoint>(trk.getExtHit()->getPosition())),
                                           module.momentumToLocal(trk.getExtHit()->getMomentum()),
                                           trk.getModuleID());
 
      TOPPixelLikelihood* topPLkhs = m_pixelData.appendNew();
      topPLkhs->setModuleID(trk.getModuleID());
 
      for (const auto& chargedStable : m_chargedStables) {
        const PDFConstructor pdfConstructor(trk, chargedStable, m_PDFOption, PDFConstructor::c_Full);
        if (not pdfConstructor.isValid()) {
          B2ERROR("PDFConstructor found not valid - bug in reconstruction code?"
                  << LogVar("PDG", chargedStable.getPDGCode()));
          continue;
        }
 
        // associate PDF peaks with photons using S-plot technique
        associatePDFPeaks(pdfConstructor);
 
        // collection of gaussian_t's for each pixel
        TOPPDFCollection::modulePDF_t channelPDFCollection;
 
        // store PDF peaks in the collection
        for (const auto& signalPDF : pdfConstructor.getSignalPDF()) {
          int pixelID = signalPDF.getPixelID();
          for (const auto& peak : signalPDF.getPDFPeaks()) {
            float position = peak.t0;
            float width = sqrt(peak.wid);
            float numPhotons = pdfConstructor.getExpectedSignalPhotons() * peak.nph;
            auto tp = TOPPDFCollection::Gaussian(position, width, numPhotons);
            channelPDFCollection.at(pixelID - 1).push_back(tp);
          } // end loop over peaks in the pdf for this pixel
        } // end loop over pixels
 
        topPDFColl->addHypothesisPDF(channelPDFCollection, chargedStable.getPDGCode());
 
        // Initialize logL and sfot pixel arrays
        TOPPixelLikelihood::PixelArray_t pixLogLs, pixSigPhots;
        pixLogLs.fill(0);
        pixSigPhots.fill(0);
 
        const auto& pixelLogLs = pdfConstructor.getPixelLogLs(0);
        for (size_t i = 0; i < std::min(pixelLogLs.size(), pixLogLs.size()); i++) {
          pixLogLs[i] = pixelLogLs[i].logL;
          pixSigPhots[i] = pixelLogLs[i].expPhotons;
        }
 
        topPLkhs->addHypothesisLikelihoods(pixLogLs, chargedStable.getPDGCode());
        topPLkhs->addHypothesisSignalPhotons(pixSigPhots, chargedStable.getPDGCode());
      }
      track.addRelationTo(topPDFColl);
      track.addRelationTo(topPLkhs);
 
    } // end loop over tracks
 
  }

event() [25/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 195 of file TOPRawDigitConverterModule.cc.

  {
 
    // get mappers
 
    const auto& feMapper = TOPGeometryPar::Instance()->getFrontEndMapper();
    const auto& chMapper = TOPGeometryPar::Instance()->getChannelMapper();
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
 
    // clear TOPDigits
 
    m_digits.clear();
 
    // set storage windows in RawDigits if not already done in unpacker
 
    for (auto& rawDigit : m_rawDigits) {
      const auto* waveform = rawDigit.getRelated<TOPRawWaveform>();
      if (waveform and rawDigit.getStorageWindows().empty()) {
        rawDigit.setStorageWindows(waveform->getStorageWindows());
      }
    }
 
    // set asic masks (asics and whole boardstacks masked in firmware for this event)
 
    m_asicMask.create();
    if (m_eventDebugs.getEntries() > 0) {
      std::vector<unsigned short> masks(64, 0xFFFF);
      for (const auto& eventDebug : m_eventDebugs) {
        auto scrodID = eventDebug.getScrodID();
        const auto* feemap = feMapper.getMap(scrodID);
        if (not feemap) {
          B2WARNING("TOPRawDigitConverter: No front-end map available."
                    << LogVar("scrodID", scrodID));
          continue;
        }
        auto moduleID = feemap->getModuleID();
        auto boardstack = feemap->getBoardstackNumber();
        unsigned bs = (moduleID - 1) * 4 + boardstack;
        if (bs < 64) {
          masks[bs] = eventDebug.getAsicMask();
        } else {
          B2ERROR("TOPRawDigitConverter: Invalid global boardstack number."
                  << LogVar("bs", bs));
        }
      }
      m_asicMask->set(masks);
    }
 
    // convert to TOPDigits
 
    for (const auto& rawDigit : m_rawDigits) {
 
      if (rawDigit.getErrorFlags() != 0) continue;
 
      // determine moduleID, pixedID and channel
 
      auto scrodID = rawDigit.getScrodID();
      const auto* feemap = feMapper.getMap(scrodID);
      if (not feemap) {
        B2WARNING("TOPRawDigitConverter: No front-end map available."
                  << LogVar("scrodID", scrodID));
        continue;
      }
      auto moduleID = feemap->getModuleID();
      auto boardstack = feemap->getBoardstackNumber();
      auto channel = chMapper.getChannel(boardstack,
                                         rawDigit.getCarrierNumber(),
                                         rawDigit.getASICNumber(),
                                         rawDigit.getASICChannel());
      auto pixelID = chMapper.getPixelID(channel);
 
      // get raw times
 
      double rawTimeLeading = rawDigit.getCFDLeadingTime(); // time in [samples]
      double rawTimeFalling = rawDigit.getCFDFallingTime(); // time in [samples]
 
      // get ASIC window
 
      int window = rawDigit.getASICWindow();
 
      // timing alignment: set time origin according to data type
 
      double timeOffset = 0;
      int storageDepth = m_storageDepth;
      if (rawDigit.getDataType() == TOPRawDigit::c_Interim) {
 
        // correct raw times for possible window discontinuity
        rawTimeLeading = rawDigit.correctTime(rawTimeLeading, m_storageDepth);
        rawTimeFalling = rawDigit.correctTime(rawTimeFalling, m_storageDepth);
 
        // set window number: number of look back windows back from the last write address
        int lastWriteAddr = rawDigit.getLastWriteAddr();
        int nback = lastWriteAddr - window;
        if (nback < 0) nback += m_storageDepth;
        int lookBackWindows = m_feSetting->getLookbackWindows();
        if (m_lookBackWindows > 0) lookBackWindows = m_lookBackWindows;
        int nwin = lookBackWindows - nback;
        window -= nwin;
        if (window < 0) window += m_storageDepth;
        if (window >= (int) m_storageDepth) window -= m_storageDepth;
 
        // add samples to raw time to account for the new window number
        rawTimeLeading += nwin * TOPRawDigit::c_WindowSize;
        rawTimeFalling += nwin * TOPRawDigit::c_WindowSize;
      } else if (rawDigit.getDataType() == TOPRawDigit::c_ProductionDebug) {
 
        // take revo9 counter and calculate corresponding SST count and its fraction
        int revo9cnt = rawDigit.getRevo9Counter();
        int SSTcnt = revo9cnt / 6;
        double SSTfrac = (revo9cnt % 6) / 6.0;
        double offset = m_feSetting->getOffset() / 24.0;
        timeOffset = (SSTfrac + offset) * m_syncTimeBase;  // in [ns], to be subtracted
 
        // find reference window
        int refWindow = SSTcnt * 2;  // seems to be the same as lastWriteAddr
        const auto& writeDepths = m_feSetting->getWriteDepths();
        if (writeDepths.empty()) {
          B2ERROR("TOPRawDigitConverter: vector of write depths is empty. Return!");
          return;
        }
        int lastDepth = writeDepths.back();
        unsigned phase = 0;
        for (auto depth : writeDepths) {
          SSTcnt -= depth;
          if (SSTcnt < 0) break;
          phase++;
          refWindow = SSTcnt * 2;
          lastDepth = depth;
        }
        if (m_setPhase) const_cast<TOPRawDigit&>(rawDigit).setPhase(phase);
        storageDepth = lastDepth * 2;
 
        if (window >= storageDepth) {
          B2WARNING("TOPRawDigitConverter: window number greater than storage depth."
                    << LogVar("window number", window)
                    << LogVar("storage depth", storageDepth)
                    << LogVar("refWindow", refWindow)
                    << LogVar("phase", phase));
          continue;
        }
 
        // set window number: number of look back windows back from the reference window
        int deltaWindow = window - refWindow;
        if (deltaWindow > 0) deltaWindow -= storageDepth;
        int lookBackWindows = m_feSetting->getLookbackWindows();
        if (m_lookBackWindows > 0) lookBackWindows = m_lookBackWindows;
        lookBackWindows -= m_feSetting->getExtraWindows();
 
        int nwin = lookBackWindows + deltaWindow;
        int startWindow = refWindow - lookBackWindows;
        if (startWindow < 0) startWindow += storageDepth;
        window = startWindow;
 
        // add samples to raw time to account for the new window number
        rawTimeLeading += nwin * TOPRawDigit::c_WindowSize;
        rawTimeFalling += nwin * TOPRawDigit::c_WindowSize;
      }
 
      // convert raw time to time using equidistant or calibrated time base
 
      unsigned short statusBits = 0;
      const auto* sampleTimes = &m_sampleTimes; // equidistant sample times
      if (m_useSampleTimeCalibration) {
        sampleTimes = m_timebase->getSampleTimes(scrodID, channel % 128);
        if (sampleTimes->isCalibrated()) {
          statusBits |= TOPDigit::c_TimeBaseCalibrated;
        }
      }
      // time and width in [ns]
      double time = sampleTimes->getTime(window, rawTimeLeading) - timeOffset;
      double width = sampleTimes->getDeltaTime(window, rawTimeFalling, rawTimeLeading);
 
      // default time uncertainty
      double timeError = geo->getNominalTDC().getTimeJitter();
 
      if (rawDigit.getDataType() == TOPRawDigit::c_MC) {
        // MC with simplified digitization
        time -= geo->getNominalTDC().getOffset();
        statusBits |= TOPDigit::c_OffsetSubtracted;
      } else {
        // data and MC with full waveform digitization
        if (m_pedestalRMS > 0) {
          double rmsNoise = m_pedestalRMS;
          if (m_noises->isCalibrated(moduleID, channel)) {
            rmsNoise = m_noises->getNoise(moduleID, channel);
          }
          double rawErr = rawDigit.getCFDLeadingTimeError(rmsNoise); // in [samples]
          int sample = static_cast<int>(rawTimeLeading);
          if (rawTimeLeading < 0) sample--;
          timeError = rawErr * sampleTimes->getTimeBin(window, sample); // [ns]
        }
 
        auto pulseHeight = rawDigit.getValuePeak();
        double timeErrorSq = timeError * timeError;
        if (m_timeWalk.isValid()) timeErrorSq += m_timeWalk->getSigmaSq(pulseHeight);
 
        if (m_useTimeWalkCalibration and m_timeWalk.isValid()) {
          if (m_timeWalk->isCalibrated()) {
            time -= m_timeWalk->getTimeWalk(pulseHeight);
          }
        }
        if (m_useChannelT0Calibration) {
          const auto& cal = m_channelT0;
          if (cal->isCalibrated(moduleID, channel)) {
            time -= cal->getT0(moduleID, channel);
            double err = cal->getT0Error(moduleID, channel);
            timeErrorSq += err * err;
            statusBits |= TOPDigit::c_ChannelT0Calibrated;
          }
        }
        if (m_useAsicShiftCalibration) {
          auto asic = channel / 8;
          if (m_asicShift->isCalibrated(moduleID, asic)) {
            time -= m_asicShift->getT0(moduleID, asic);
          }
        }
        if (m_useModuleT0Calibration) {
          const auto& cal = m_moduleT0;
          if (cal->isCalibrated(moduleID)) {
            time -= cal->getT0(moduleID);
            double err = cal->getT0Error(moduleID);
            timeErrorSq += err * err;
            statusBits |= TOPDigit::c_ModuleT0Calibrated;
          }
        }
        if (m_useCommonT0Calibration) {
          const auto& cal = m_commonT0;
          if (cal->isCalibrated()) {
            time -= cal->getT0();
            double err = cal->getT0Error();
            timeErrorSq += err * err;
            statusBits |= TOPDigit::c_CommonT0Calibrated;
          }
        }
        timeError = sqrt(timeErrorSq);
      }
 
      // append new TOPDigit and set it
 
      auto* digit = m_digits.appendNew(moduleID, pixelID, rawTimeLeading);
      digit->setTime(time);
      digit->setTimeError(timeError);
      digit->setPulseHeight(rawDigit.getValuePeak());
      digit->setIntegral(rawDigit.getIntegral());
      digit->setPulseWidth(width);
      digit->setChannel(channel);
      digit->setFirstWindow(window);
      digit->setStatus(statusBits);
      if (m_addRelations) digit->addRelationTo(&rawDigit);
 
      if (not rawDigit.isFEValid() or rawDigit.isPedestalJump())
        digit->setHitQuality(TOPDigit::c_Junk);
      if (rawDigit.isAtWindowDiscontinuity(storageDepth))
        digit->setHitQuality(TOPDigit::c_Junk);
      if (digit->getPulseWidth() < m_minPulseWidth or
          digit->getPulseWidth() > m_maxPulseWidth or
          digit->getPulseWidth() * digit->getPulseHeight() < m_minWidthXheight)
        digit->setHitQuality(TOPDigit::c_Junk);
    }
 
    // if calibration channel given, select and flag cal pulses
 
    unsigned calibrationChannel = m_calibrationChannel;
    if (calibrationChannel < 8) {
      for (auto& digit : m_digits) {
        if (digit.getHitQuality() != TOPDigit::c_Good) continue;
        if (digit.getASICChannel() != calibrationChannel) continue;
        if (digit.getPulseHeight() < m_calpulseHeightMin) continue;
        if (digit.getPulseHeight() > m_calpulseHeightMax) continue;
        if (digit.getPulseWidth() < m_calpulseWidthMin) continue;
        if (digit.getPulseWidth() > m_calpulseWidthMax) continue;
        if (m_calpulseTimeMax > m_calpulseTimeMin) {
          if (digit.getTime() < m_calpulseTimeMin) continue;
          if (digit.getTime() > m_calpulseTimeMax) continue;
        }
        digit.setHitQuality(TOPDigit::c_CalPulse);
      }
    }
 
  }

event() [26/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 91 of file TOPReconstructorModule.cc.

  {
    // clear output collections
 
    m_likelihoods.clear();
    m_topPulls.clear();
 
    // check bunch reconstruction status and do the reconstruction:
    // - if object exists and bunch is found (collision data w/ bunch finder in the path)
    // - if object doesn't exist (cosmic data and other cases w/o bunch finder in the path)
 
    if (m_recBunch.isValid()) {
      if (not m_recBunch->isReconstructed()) return;
    }
 
    // set time window in which photon hits are accepted for likelihood determination
 
    TOPRecoManager::setTimeWindow(m_minTime, m_maxTime);
 
    // sort tracks by module ID
 
    std::unordered_multimap<int, const TOPTrack*> topTracks; // tracks sorted by top modules
    for (const auto& track : m_tracks) {
      auto* trk = new TOPTrack(track, m_topDigitCollectionName);
      if (trk->isValid() and trk->getTransverseMomentum() > m_pTCut) {
        topTracks.emplace(trk->getModuleID(), trk);
      } else {
        delete trk;
      }
    }
 
    // reconstruct module-by-module
 
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    for (unsigned moduleID = 1; moduleID <= geo->getNumModules(); moduleID++) {
 
      // make a vector of PDF collections for a given TOP module
 
      std::vector<PDFCollection> pdfCollections;
      const auto& range = topTracks.equal_range(moduleID);
      for (auto it = range.first; it != range.second; ++it) {
        const auto* trk = it->second;
        PDFCollection collection(*trk, m_deltaRayModeling);
        if (collection.isValid) pdfCollections.push_back(collection);
      }
      if (pdfCollections.empty()) continue;
 
      // add most probable PDF's of other tracks if present
 
      if (pdfCollections.size() > 1) {
        std::vector<int> lastMostProbables;
        for (int iter = 0; iter < 10; iter++) {
          std::vector<int> mostProbables;
          for (auto& collection : pdfCollections) { // set most probable PDF
            collection.setMostProbable();
            mostProbables.push_back(collection.mostProbable->getHypothesis().getPDGCode());
          }
          if (mostProbables == lastMostProbables) break;
          else lastMostProbables = mostProbables;
 
          for (auto& collection : pdfCollections) collection.clearPDFOther(); // reset
          for (auto& collection : pdfCollections) { // append
            for (auto& other : pdfCollections) {
              if (&other == &collection) continue;
              collection.appendPDFOther(other.mostProbable);
            }
          }
        } // loop: iter
      }
 
      // determine and save log likelihoods
 
      for (auto& collection : pdfCollections) {
        auto* topLL = m_likelihoods.appendNew();
        const auto* trk = collection.topTrack;
        const auto* track = trk->getTrack();
        track->addRelationTo(topLL);
        topLL->addRelationTo(trk->getExtHit());
        topLL->addRelationTo(trk->getBarHit());
 
        int pdgCode = (m_PDGCode != 0) ? m_PDGCode : trk->getPDGCode(); // PDG code used for providing pulls
        std::set<int> nfotSet;    // to x-check if the number of photons is the same for all particle hypotheses
        std::set<double> nbkgSet; // to x-check if the background is the same for all particle hypotheses
 
        for (const auto* pdfConstructor : collection.PDFs) {
          const auto& chargedStable = pdfConstructor->getHypothesis();
          auto LL = pdfConstructor->getLogL();
          auto expBkgPhotons = pdfConstructor->getExpectedBkgPhotons();
          topLL->set(chargedStable, LL.numPhotons, LL.logL, LL.expPhotons, expBkgPhotons, LL.effectiveSignalYield);
 
          nfotSet.insert(LL.numPhotons);
          nbkgSet.insert(expBkgPhotons);
 
          if (abs(chargedStable.getPDGCode()) == abs(pdgCode)) {
            for (const auto& p : pdfConstructor->getPulls()) {
              auto* pull = m_topPulls.appendNew(p.pixelID, p.time, p.peakT0 + p.ttsT0, p.sigma, p.phiCer, p.wt);
              track->addRelationTo(pull);
            }
          }
        }
        topLL->setFlag(1);
        topLL->setModuleID(trk->getModuleID());
        const auto& emi = trk->getEmissionPoint();
        topLL->setXZ(emi.position.X(), emi.position.Z());
 
        if (nfotSet.size() > 1) B2ERROR("Bug in TOP::PDFConstructor: number of photons differs between particle hypotheses");
        if (nbkgSet.size() > 1) B2ERROR("Bug in TOP::PDFConstructor: estimated background differs between particle hypotheses");
      }
 
      for (auto& collection : pdfCollections) collection.deletePDFs();
 
    } // loop: moduleID
 
    for (auto& x : topTracks) delete x.second;
 
  }

event() [27/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from HistoModule.

Definition at line 347 of file TOPTBCComparatorModule.cc.

  {
    return;
  }

event() [28/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 147 of file TOPTimeBaseCalibratorModule.cc.

  {
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    double sampleWidth = geo->getNominalTDC().getSampleWidth();
 
    vector<Hit> hits[c_NumChannels];
 
    for (const auto& digit : m_digits) {
      if (digit.getModuleID() != m_moduleID) continue;
      if (digit.getHitQuality() != TOPDigit::c_Junk) {
        m_goodHits.Fill(digit.getPulseWidth(), digit.getPulseHeight());
      }
      if (digit.getHitQuality() != TOPDigit::c_CalPulse) continue;
      double rawTime = digit.getRawTime();
      double errScaleFactor = 1;
      if (m_useFallingEdge) {
        const auto* rawDigit = digit.getRelated<TOPRawDigit>();
        if (!rawDigit) {
          B2ERROR("No relation to TOPRawDigit - can't determine falling edge time error");
          continue;
        }
        // rawTime may include corrections due to window number discontinuity,
        // therefore one must add the width and not just use getCFDFallingTime()
        rawTime += rawDigit->getFWHM();
        errScaleFactor = rawDigit->getCFDFallingTimeError(1.0) / rawDigit->getCFDLeadingTimeError(1.0);
      }
      double t = rawTime + digit.getFirstWindow() * c_WindowSize;
      if (t < 0) {
        B2ERROR("Got negative sample number - digit ignored");
        continue;
      }
      double et = digit.getTimeError() / sampleWidth * errScaleFactor;
      if (et <= 0) {
        B2ERROR("Time error is not given - digit ignored");
        continue;
      }
      unsigned channel = digit.getChannel();
      if (channel < c_NumChannels) {
        hits[channel].push_back(Hit(t, et, digit.getPulseHeight(), digit.getPulseWidth()));
      }
    }
 
    for (unsigned channel = 0; channel < c_NumChannels; channel++) {
      const auto& channelHits = hits[channel];
      if (channelHits.size() == 2) {
        double t0 = channelHits[0].time;
        double t1 = channelHits[1].time;
        auto diff = fabs(t0 - t1); // since not sorted yet
        if (diff < m_minTimeDiff) continue;
        if (diff > m_maxTimeDiff) continue;
        double sig0 = channelHits[0].timeErr;
        double sig1 = channelHits[1].timeErr;
        double sigma = sqrt(sig0 * sig0 + sig1 * sig1);
        m_ntuples[channel].push_back(TwoTimes(t0, t1, sigma));
        if (t0 < t1) { // check, since not sorted yet
          m_calPulseFirst.Fill(channelHits[0].pulseWidth, channelHits[0].pulseHeight);
          m_calPulseSecond.Fill(channelHits[1].pulseWidth, channelHits[1].pulseHeight);
        } else {
          m_calPulseSecond.Fill(channelHits[0].pulseWidth, channelHits[0].pulseHeight);
          m_calPulseFirst.Fill(channelHits[1].pulseWidth, channelHits[1].pulseHeight);
        }
      } else if (channelHits.size() > 2) {
        B2WARNING("More than two cal pulses per channel found - ignored");
      }
    }
 
  }

event() [29/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 143 of file TOPTimeRecalibratorModule.cc.

  {
    int revo9cnt = m_recBunch->getRevo9Counter();
    double SSTfrac = (revo9cnt % 6) / 6.0;
    double offset = m_feSetting->getOffset() / 24.0;
    double timeOffset = (SSTfrac + offset) * m_syncTimeBase;  // in [ns], to be subtracted
    const auto& feMapper = TOPGeometryPar::Instance()->getFrontEndMapper();
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
 
    for (auto& digit : m_digits) {
 
      // save MC offset status
      bool offsetStatus = digit.hasStatus(TOPDigit::c_OffsetSubtracted);
 
      // reset status bits
      unsigned short statusBits = 0;
      digit.setStatus(statusBits);
 
      // get what's needed from a digit
      double rawTimeLeading = digit.getRawTime();
      auto window = digit.getFirstWindow();
      auto moduleID = digit.getModuleID();
      auto channel = digit.getChannel();
 
      // convert raw time to time using equidistant or calibrated time base
      const auto* sampleTimes = &m_sampleTimes; // equidistant sample times
      if (m_useSampleTimeCalibration) {
        auto bs = channel / 128;
        const auto* feemap = feMapper.getMap(moduleID, bs);
        if (not feemap) {
          B2ERROR("No front-end map available."
                  << LogVar("slot", moduleID)
                  << LogVar("boardstack", bs));
          continue;
        }
        auto scrodID = feemap->getScrodID();
        sampleTimes = m_timebase->getSampleTimes(scrodID, channel % 128);
        if (sampleTimes->isCalibrated()) {
          statusBits |= TOPDigit::c_TimeBaseCalibrated;
        }
      }
      double time = sampleTimes->getTime(window, rawTimeLeading) - timeOffset;
 
      // apply other calibrations
      if (m_useTimeWalkCalibration and m_timeWalk.isValid()) {
        if (m_timeWalk->isCalibrated()) {
          time -= m_timeWalk->getTimeWalk(digit.getPulseHeight());
        }
      }
      if (m_useChannelT0Calibration) {
        const auto& cal = m_channelT0;
        if (cal->isCalibrated(moduleID, channel)) {
          time -= cal->getT0(moduleID, channel);
          statusBits |= TOPDigit::c_ChannelT0Calibrated;
        }
      }
      if (m_useAsicShiftCalibration) {
        auto asic = channel / 8;
        if (m_asicShift->isCalibrated(moduleID, asic)) {
          time -= m_asicShift->getT0(moduleID, asic);
        }
      }
      if (m_useModuleT0Calibration) {
        const auto& cal = m_moduleT0;
        if (cal->isCalibrated(moduleID)) {
          time -= cal->getT0(moduleID);
          statusBits |= TOPDigit::c_ModuleT0Calibrated;
        }
      }
      if (m_useCommonT0Calibration) {
        const auto& cal = m_commonT0;
        if (cal->isCalibrated()) {
          time -= cal->getT0();
          statusBits |= TOPDigit::c_CommonT0Calibrated;
        }
      }
 
      // subtract bunch time
      if (m_subtractBunchTime and m_recBunch->isReconstructed()) {
        time -= m_recBunch->getTime();
        statusBits |= TOPDigit::c_EventT0Subtracted;
      }
 
      // subtract offset used in MC if status bit was set in this digit
      if (offsetStatus) {
        time -= geo->getNominalTDC().getOffset();
        statusBits |= TOPDigit::c_OffsetSubtracted;
      }
 
      // set re-calibrated time and status bits
      digit.setTime(time);
      digit.setStatus(statusBits);
    }
 
  }

event() [30/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 118 of file TOPUnpackerModule.cc.

  {
    if (m_resetEventCount) {
      m_numErrors = m_errorCount;
      m_errorCount = 0;
      m_eventCount = 0;
      m_resetEventCount = false;
    }
    m_eventCount++;
 
    // clear output store arrays
    m_digits.clear();
    m_rawDigits.clear();
    m_waveforms.clear();
    m_productionEventDebugs.clear();
    m_productionHitDebugs.clear();
    m_templateFitResults.clear();
    m_slowData.clear();
    m_interimFEInfos.clear();
 
    StoreObjPtr<EventMetaData> evtMetaData;
    for (auto& raw : m_rawData) {
      for (int finesse = 0; finesse < raw.GetMaxNumOfCh(0); finesse++) {
        const int* buffer = raw.GetDetectorBuffer(0, finesse);
        int bufferSize = raw.GetDetectorNwords(0, finesse);
        if (bufferSize < 1) continue;
 
        int err = 0;
 
        int dataFormat = m_dataFormat;
        if (dataFormat == 0) { // auto detect data format
          DataArray array(buffer, bufferSize, m_swapBytes);
          unsigned word = array.getWord();
          dataFormat = (word >> 16);
          bool isKnownDataFormat = false;
          for (auto& t : TOP::membersRawDataType) {
            if (static_cast<int>(t) == dataFormat) {
              isKnownDataFormat = true;
              break;
            }
          }
 
          if (!isKnownDataFormat) { //dataformat word is not recognised, might be interim format.
            if (evtMetaData->getExperiment() == 1) { // all exp.1 data was taken with interim format
              dataFormat = 0x0301;
              m_swapBytes = true;
            } else {
              if (unpackHeadersInterimFEVer01(buffer, bufferSize, true)) { //if buffer unpacks without errors assuming it's interim format
                B2DEBUG(22, "Assuming interim FW data format");
                dataFormat = 0x0301; //assume it's interim format
                m_swapBytes = true;
              } else {
                B2WARNING("TOPUnpacker: Could not establish data format.");
                err = bufferSize;
              }
            }
          }
        }
 
        switch (dataFormat) {
          case static_cast<int>(TOP::RawDataType::c_Type0Ver16):
            unpackType0Ver16(buffer, bufferSize);
            break;
          case static_cast<int>(TOP::RawDataType::c_Type2Ver1):
            err = unpackInterimFEVer01(buffer, bufferSize, false);
            break;
          case static_cast<int>(TOP::RawDataType::c_Type3Ver1):
            err = unpackInterimFEVer01(buffer, bufferSize, true);
            break;
          case static_cast<int>(TOP::RawDataType::c_Draft):
            unpackProductionDraft(buffer, bufferSize);
            break;
          case static_cast<int>(TOP::RawDataType::c_ProductionDebug01):
            err = unpackProdDebug(buffer, bufferSize, TOP::RawDataType::c_ProductionDebug01, true);
            break;
          case static_cast<int>(TOP::RawDataType::c_ProductionDebug02):
            err = unpackProdDebug(buffer, bufferSize, TOP::RawDataType::c_ProductionDebug02, true);
            break;
 
          default:
            if (printTheError()) {
              B2ERROR("TOPUnpacker: unknown data format, " << getFrontEndName(raw, finesse)
                      << LogVar("Type", (dataFormat >> 8))
                      << LogVar("Version", (dataFormat & 0xFF)));
            }
            return;
        }
 
        if (err != 0) {
          if (printTheError()) {
            B2ERROR("TOPUnpacker: error in unpacking data from " << getFrontEndName(raw, finesse)
                    << LogVar("words unused", err));
          }
        }
 
      } // finesse loop
    } // m_rawData loop
 
  }

event() [31/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from Module.

Definition at line 82 of file TOPWaveformFeatureExtractorModule.cc.

  {
 
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    const auto& tdc = geo->getNominalTDC();
    int sampleDivisions = 0x1 << tdc.getSubBits();
 
    StoreArray<TOPRawDigit> rawDigits(m_inputRawDigitsName);
    int initSize = rawDigits.getEntries();
 
    for (int i = 0; i < initSize; i++) {
      auto& rawDigit = *rawDigits[i];
      const auto* waveform = rawDigit.getRelated<TOPRawWaveform>();
      if (!waveform) continue;
      if (m_setIntegral) {
        auto integral = waveform->getIntegral(rawDigit.getSampleRise(),
                                              rawDigit.getSamplePeak(),
                                              rawDigit.getSampleFall());
        rawDigit.setIntegral(integral);
      }
      waveform->featureExtraction(m_threshold, m_hysteresis, m_thresholdCount);
      const auto& features = waveform->getFeatureExtractionData();
      int sampleRise = rawDigit.getSampleRise();
      int sampleFall = rawDigit.getSampleFall() + 1;
      for (const auto& feature : features) {
 
        // skip it, if hit already in rawDigits
        int sRise = feature.sampleRise;
        if (sRise >= sampleRise and sRise <= sampleFall) continue;
        int sFall = feature.sampleFall + 1;
        if (sFall >= sampleRise and sFall <= sampleFall) continue;
 
        // if not, append it
        auto* newDigit = rawDigits.appendNew(rawDigit);
        newDigit->setOfflineFlag();
        newDigit->setSampleRise(feature.sampleRise);
        newDigit->setDeltaSamplePeak(feature.samplePeak - feature.sampleRise);
        newDigit->setDeltaSampleFall(feature.sampleFall - feature.sampleRise);
        newDigit->setValueRise0(feature.vRise0);
        newDigit->setValueRise1(feature.vRise1);
        newDigit->setValueFall0(feature.vFall0);
        newDigit->setValueFall1(feature.vFall1);
        newDigit->setValuePeak(feature.vPeak);
        newDigit->setIntegral(feature.integral);
        double rawTime = newDigit->getCFDLeadingTime();
        unsigned tfine = int(rawTime * sampleDivisions) % sampleDivisions; // TODO: <0 ?
        newDigit->setTFine(tfine);
        newDigit->addRelationTo(waveform);
      }
    }
 
    int finalSize = rawDigits.getEntries();
    B2DEBUG(20, "TOPWaveformFeatureExtractor: appended " << finalSize - initSize
            << " raw digits to initial " << initSize);
 
  }

event() [32/32]

void event ( void  )

overridevirtual

Event processor.

Reimplemented from HistoModule.

Definition at line 145 of file TOPWaveformQualityPlotterModule.cc.

  {
    if (not m_waveform) {
      return;
    }
    for (auto evtwave : m_waveform) {
      if (m_DRAWWAVES) {
        drawWaveforms(evtwave);
      }
      if (m_DEBUGGING) {
        basicDebuggingPlots(evtwave);
      }
      if (m_NOISE) {
        auto channelID = evtwave.getChannel();
        const vector<short> v_samples = evtwave.getWaveform();
        size_t nsamples = v_samples.size();
        if (m_channelNoiseMap.find(channelID) == m_channelNoiseMap.end()) {
          string idName = string("noise_") + to_string(channelID);
          m_channelNoiseMap.insert(make_pair(channelID, new TH1F(idName.c_str(), idName.c_str(), 200, -100, 100)));
          m_channelEventMap.insert(make_pair(channelID, m_iEvent));
        }
        TH1F* noise = m_channelNoiseMap[channelID];
        // Plot all samples in common histogram for quick sanity check
        for (size_t s = 0; s < nsamples; s++) {
          double adc = v_samples.at(s);
          m_samples->Fill(adc);
          if (s < nsamples - 1) {
            noise->Fill(v_samples[s + 1] - adc);
          }
        }
      }
    }
    m_iEvent += 1;
    return;
  }

FindPeakForSmallerXThan()

double FindPeakForSmallerXThan ( TH1 *  histo, double  xmax = 0  )

static

Find peak and return its position for a limited range of x (x smaller than the given value (xmax))

Definition at line 646 of file TOPGainEfficiencyCalculatorModule.cc.

  {
    double histo_xmax = histo->GetXaxis()->GetBinUpEdge(histo->GetXaxis()->GetNbins() - 1);
    if (xmax > histo_xmax) xmax = histo_xmax;
 
    int iBin = 1;
    double peakPos = histo->GetXaxis()->GetBinCenter(iBin);
    double peakCharge = histo->GetBinContent(iBin);
    while (true) {
      iBin++;
      double x = histo->GetXaxis()->GetBinCenter(iBin);
      if (x > xmax) break;
 
      double binEntry = histo->GetBinContent(iBin);
      if (binEntry > peakCharge) {
        peakPos = x;
        peakCharge = binEntry;
      }
    }
 
    return peakPos;
  }

FitHistograms()

void FitHistograms

(

EHistogramType

LoadHisto

)

Fit charge (or integrated charged) distribution to calculate gain and efficiency for each channel.

Definition at line 276 of file TOPGainEfficiencyCalculatorModule.cc.

  {
    float threshold = m_threshold;
    int globalAsicId = 0;
    if (LoadHisto == c_LoadForFitIntegral || LoadHisto == c_LoadHitRateIntegral) threshold = m_thresholdForIntegral;
 
    for (int iHisto = 0 ; iHisto < c_NChannelPerPMT ; iHisto++) {
      if (m_targetPmtChId != -1 && iHisto + 1 != m_targetPmtChId) continue;
 
      m_pixelId = ((m_targetPmtId - 1) % c_NPMTPerRow) * c_NChannelPerPMTRow
                  + ((m_targetPmtId - 1) / c_NPMTPerRow) * c_NPixelPerModule / 2
                  + (iHisto / c_NChannelPerPMTRow) * c_NPixelPerRow + (iHisto % c_NChannelPerPMTRow) + 1;
      m_pmtChId = (iHisto + 1);
      globalAsicId = ((m_targetSlotId - 1) * c_NPixelPerModule + (m_pixelId - 1)) / c_NChannelPerAsic;
      if (LoadHisto == c_LoadForFitHeight) {
        for (auto itr = m_branch[0].begin(); itr != m_branch[0].end(); ++itr) {
          (*itr)->Fill();
        }
      }
 
      TH1D* hCharge = m_chargeHistogram[iHisto];
      if (!hCharge) { DummyFillBranch(LoadHisto); continue;}
 
      std::cout << " ***** fitting charge distribution for " << hCharge->GetName() << " *****" << std::endl;
      int nBins = hCharge->GetXaxis()->GetNbins();
      double binWidth = hCharge->GetXaxis()->GetBinUpEdge(1) - hCharge->GetXaxis()->GetBinLowEdge(1);
      double histoMax = hCharge->GetXaxis()->GetBinUpEdge(nBins);
      m_fitMax = threshold;
      double wholeIntegral = hCharge->Integral(0, hCharge->GetXaxis()->GetNbins() + 1);
      double fitRangeFraction = (m_fracFit > 0 ? m_fracFit : 1. - 10. / wholeIntegral);
      while (hCharge->Integral(0, hCharge->GetXaxis()->FindBin(m_fitMax - 0.01 * binWidth)) / wholeIntegral < fitRangeFraction)
        m_fitMax += binWidth;
      if (m_fitMax < threshold + static_cast<double>(c_NParameterGainFit) * binWidth) {
        B2WARNING("TOPGainEfficiencyCalculator : no enough entries for fitting at slot"
                  << std::setw(2) << std::setfill('0') << m_targetSlotId << ", PMT"
                  << std::setw(2) << std::setfill('0') << m_targetPmtId << ", Ch"
                  << std::setw(2) << std::setfill('0') << m_pmtChId);
        DummyFillBranch(LoadHisto); continue;
      }
 
      std::ostringstream fname;
      fname << "func_" << (iHisto + 1);
      TObject* object = gROOT->FindObject(fname.str().c_str());
      if (object) delete object;
      TF1* func = new TF1(fname.str().c_str(), TOPGainFunc, threshold, m_fitMax, c_NParameterGainFit);
      double initGain = TMath::Max(hCharge->GetMean(), 26.1) - 25;
      double initP1 = TMath::Min(4.0, TMath::Max(10000.*TMath::Power(initGain - 25, -2), 0.01));
      double initP2 = TMath::Min(0.8 + 0.005 * TMath::Power(initP1, -3), 4.);
      double initX0 = TMath::Max(initGain * 2 - 150, 10.);
      //if (initP1 > initP2) initX0 = initX0 / 10.
      double initP1overP2 = initP1 / initP2;
      double initP0 = hCharge->GetBinContent(hCharge->GetMaximumBin())
                      / (TMath::Power(initP1overP2, initP1overP2) * TMath::Exp(-initP1overP2)) / binWidth;
      if (m_initialX0 < 0)func->SetParameter(3, initX0);
      else if (LoadHisto == c_LoadForFitHeight)
        func->SetParameter(3, 150 + 0.5 * hCharge->GetMean());
      else if (LoadHisto == c_LoadForFitIntegral)
        func->SetParameter(3, 1000 + 0.5 * hCharge->GetMean());
      if (m_initialP2 < 0)func->SetParameter(2, initP2);
      else              func->SetParameter(2, m_initialP2);
      if (m_initialP1 < 0)func->SetParameter(1, initP1);
      else              func->SetParameter(1, m_initialP1);
      if (m_initialP0 < 0)func->SetParameter(0, initP0);
      else              func->SetParameter(0, m_initialP0 * hCharge->GetEntries()*binWidth);
 
      func->FixParameter(4, 0);
      func->FixParameter(5, m_pedestalSigma);
      func->SetParName(0, "#it{p}_{0}");
      func->SetParName(1, "#it{p}_{1}");
      func->SetParName(2, "#it{p}_{2}");
      func->SetParName(3, "#it{x}_{0}");
      func->SetParName(4, "pedestal");
      func->SetParName(5, "pedestal #sigma");
      func->SetParLimits(0, 1e-8, 1e8);
      func->SetParLimits(1, 1e-8, 10);
      func->SetParLimits(2, 1e-8, 10);
      func->SetParLimits(3, 1e-8, 1e8);
      func->SetLineColor(2);
      func->SetLineWidth(1);
      TF1* funcFull = NULL;
      if (LoadHisto == c_LoadForFitHeight or LoadHisto == c_LoadForFitIntegral) {
        hCharge->Fit(func, m_fitoption.c_str(), "", threshold, m_fitMax);
 
        if (func->GetNDF() < 2) { DummyFillBranch(LoadHisto); continue;}
 
        double funcFullMax = histoMax * 2;
        funcFull = new TF1((fname.str() + "_full").c_str(), TOPGainFunc, (-1)*func->GetParameter(5), funcFullMax, c_NParameterGainFit);
        for (int iPar = 0 ; iPar < c_NParameterGainFit ; iPar++)
          funcFull->SetParameter(iPar, func->GetParameter(iPar));
        funcFull->SetLineColor(3);
        funcFull->SetLineWidth(2);
 
        double totalWeight = 0;
        double weightedIntegral = 0;
        double x = (-1) * func->GetParameter(5);
        while (x < funcFullMax) {
          double funcVal = funcFull->Eval(x);
          totalWeight += funcVal;
          weightedIntegral += funcVal * x;
          x += binWidth / 5.;
        }
 
        //fill results to the output TTree
        m_gain = weightedIntegral / totalWeight;
        m_efficiency = funcFull->Integral(threshold, funcFullMax) / funcFull->Integral((-1) * func->GetParameter(5), funcFullMax);
        m_p0 = func->GetParameter(0);
        m_p1 = func->GetParameter(1);
        m_p2 = func->GetParameter(2);
        m_x0 = func->GetParameter(3);
        m_p0Error = func->GetParError(0);
        m_p1Error = func->GetParError(1);
        m_p2Error = func->GetParError(2);
        m_x0Error = func->GetParError(3);
        m_chisquare = func->GetChisquare();
        m_ndf = func->GetNDF();
        m_funcFullRangeIntegral = funcFull->Integral((-1) * func->GetParameter(5), funcFullMax) / binWidth;
        m_funcFitRangeIntegral = funcFull->Integral(threshold, m_fitMax) / binWidth;
      } else std::cout << "*****fitting is skipped***** " << std::endl;
      int threBin = hCharge->GetXaxis()->FindBin(threshold + 0.01 * binWidth);
      int fitMaxBin = hCharge->GetXaxis()->FindBin(m_fitMax - 0.01 * binWidth);
      m_histoFitRangeIntegral = hCharge->Integral(threBin, fitMaxBin);
 
      m_histoMeanAboveThre = 0;
      for (int iBin = threBin ; iBin < nBins + 1 ; iBin++) {
        m_histoMeanAboveThre += (hCharge->GetBinContent(iBin) * hCharge->GetXaxis()->GetBinCenter(iBin));
      }
      m_histoMeanAboveThre /= hCharge->Integral(threBin, nBins);
      m_nEntries = hCharge->GetEntries();
      m_nCalPulse = (m_nCalPulseHistogram ? m_nCalPulseHistogram->GetBinContent(globalAsicId + 1) : -1);
      m_nOverflowEvents = TMath::FloorNint(hCharge->GetBinContent(nBins + 1));
      m_meanPulseHeight = hCharge->GetMean();
      m_meanPulseHeightError = hCharge->GetMeanError();
      m_hitTiming = 0;
      m_hitTimingSigma = -1;
 
      TF1* funcLaser = m_funcForLaser[iHisto];
      if (m_timeHistogram[iHisto] && funcLaser) {
        m_hitTiming = funcLaser->GetParameter(1);
        m_hitTimingSigma = funcLaser->GetParameter(2);
      }
 
      m_funcForFitRange[iHisto] = func;
      m_funcForFullRange[iHisto] = funcFull;
 
      for (auto itr = m_branch[LoadHisto].begin(); itr != m_branch[LoadHisto].end(); ++itr) {
        (*itr)->Fill();
      }
 
      std::cout << std::endl;
    }
    if (m_targetPmtChId == -1) m_tree->SetEntries(c_NChannelPerPMT);
    else m_tree->SetEntries(1);
 
    return;
  }

generatePulseHeight()

double generatePulseHeight ( int  moduleID, int  pixelID  ) const

private

Generates and returns pulse height.

Parameters

moduleID	module ID (1-based)
pixelID	pixel ID (1-based)

Returns

pulse height [ADC counts]

Definition at line 533 of file TOPDigitizerModule.cc.

  {
    if (m_useDatabase) {
      const auto& channelMapper = TOPGeometryPar::Instance()->getChannelMapper();
      auto channel = channelMapper.getChannel(pixelID);
      if (m_pulseHeights->isCalibrated(moduleID, channel)) {
        const auto& par = m_pulseHeights->getParameters(moduleID, channel);
        PulseHeightGenerator generator(par.x0, par.p1, par.p2, m_ADCmax);
        return generator.generate();
      }
    }
 
    return m_pulseHeightGenerator.generate();
  }

getDirectionCustom()

XYZVector getDirectionCustom ( ) const

private

Return photon direction according to a custom angular distribution given by TFormula.

Returns

photon direction (unit vector)

Definition at line 269 of file OpticalGunModule.cc.

  {
    double alpha = m_customDistribution->GetRandom();
    double phi = 2.0 * M_PI * gRandom->Rndm();
    return XYZVector(cos(phi) * sin(alpha), sin(phi) * sin(alpha), cos(alpha));
  }

getDirectionGaussian()

XYZVector getDirectionGaussian ( ) const

private

Return photon direction according to a projected 2D gaussian distribution based on numerical aperture NA.

Returns

photon direction (unit vector)

Definition at line 237 of file OpticalGunModule.cc.

  {
    // NA is defined as the aperture where the amplitude is 5% of that of the
    // peak, which translates into 2.45 sigma for a gaussian distribution
    double x = 0;
    double y = 0;
    double z = 0;
    do {
      x = gRandom->Gaus(0., asin(m_na) / 2.45);
      y = gRandom->Gaus(0., asin(m_na) / 2.45);
      z = 1. - x * x - y * y;
    } while (z < 0);
    return XYZVector(x, y, sqrt(z));
  }

getDirectionLambertian()

XYZVector getDirectionLambertian ( ) const

private

Return photon direction according to a lambertian distribution with opening angle alpha.

Returns

photon direction (unit vector)

Definition at line 260 of file OpticalGunModule.cc.

  {
    double cosTheta = sqrt((m_cosMinAlpha * m_cosMinAlpha - m_cosMaxAlpha * m_cosMaxAlpha) * gRandom->Rndm() +
                           m_cosMaxAlpha * m_cosMaxAlpha);
    double sinTheta = sqrt(1.0 - cosTheta * cosTheta);
    double phi = 2.0 * M_PI * gRandom->Rndm();
    return XYZVector(cos(phi) * sinTheta, sin(phi) * sinTheta, cosTheta);
  }

getDirectionUniform()

XYZVector getDirectionUniform ( ) const

private

Return photon direction according to a projected uniform distribution with opening angle alpha.

Be careful.

Returns

photon direction (unit vector)

Definition at line 252 of file OpticalGunModule.cc.

  {
    double cosTheta = (m_cosMinAlpha - m_cosMaxAlpha) * gRandom->Rndm() + m_cosMaxAlpha;
    double sinTheta = sqrt(1.0 - cosTheta * cosTheta);
    double phi = 2.0 * M_PI * gRandom->Rndm();
    return XYZVector(cos(phi) * sinTheta, sin(phi) * sinTheta, cosTheta);
  }

getFrontEndName()

std::string getFrontEndName ( RawTOP &  raw, int  finesse  ) const

private

Returns the name of the front-end.

Parameters

raw	raw data
finesse	finesse number

Returns

front-end name

Definition at line 219 of file TOPUnpackerModule.cc.

  {
    std::string name;
    if (raw.GetMaxNumOfCh(0) <= 4) { // COPPER
      int copper = ((raw.GetNodeID(0) >> 24) * 1000 + (raw.GetNodeID(0) & 0x3FF));
      name = "frontend cpr" + std::to_string(copper) + char('a' + finesse);
    } else { // PCIe40
      int slot = (raw.GetNodeID(0) & 0xF) * 8 - 7 + finesse / 4;
      name = (slot < 10) ? "boardstack s0" : "boardstack s";
      name += std::to_string(slot) + char('a' + finesse % 4);
    }
    return name;
  }

getModuleID()

int getModuleID ( const Track &  track ) const

private

Returns slot ID of the module that is hit by the track.

Parameters

track

charged track

Returns

slotID or 0 if track does not hit any module

Definition at line 460 of file TOPDQMModule.cc.

  {
    Const::EDetector myDetID = Const::EDetector::TOP;
    int pdgCode = std::abs(Const::pion.getPDGCode());
 
    RelationVector<ExtHit> extHits = track.getRelationsWith<ExtHit>();
    for (const auto& extHit : extHits) {
      if (std::abs(extHit.getPdgCode()) != pdgCode) continue;
      if (extHit.getDetectorID() != myDetID) continue;
      if (extHit.getCopyID() < 1 or extHit.getCopyID() > m_numModules) continue;
      return extHit.getCopyID();
    }
 
    return 0;
  }

getMostProbable()

Const::ChargedStable getMostProbable ( const Track &  track )

private

Returns most probable charged stable particle according to dEdx and predefined prior probabilities.

Parameters

track

reconstructed track

Returns

charged stable

Definition at line 564 of file TOPBunchFinderModule.cc.

  {
 
    std::vector<double> logL;
    std::vector<double> priors;
 
    if (m_usePIDLikelihoods) {
      const auto* pid = track.getRelated<PIDLikelihood>();
      if (not pid) {
        m_nodEdxCount++;
        return Const::pion;
      }
      auto subset = Const::PIDDetectorSet(Const::SVD);
      subset += Const::PIDDetectorSet(Const::CDC);
      for (const auto& type : Const::chargedStableSet) {
        logL.push_back(pid->getLogL(type, subset));
        priors.push_back(m_priors[abs(type.getPDGCode())]);
      }
    } else {
      const auto* cdcdedx = track.getRelated<CDCDedxLikelihood>();
      const auto* vxddedx = track.getRelated<VXDDedxLikelihood>();
      if (not cdcdedx and not vxddedx) {
        m_nodEdxCount++;
        return Const::pion;
      }
      for (const auto& type : Const::chargedStableSet) {
        if (cdcdedx and vxddedx) {
          logL.push_back(cdcdedx->getLogL(type) + vxddedx->getLogL(type));
        } else if (cdcdedx) {
          logL.push_back(cdcdedx->getLogL(type));
        } else {
          logL.push_back(vxddedx->getLogL(type));
        }
        priors.push_back(m_priors[abs(type.getPDGCode())]);
      }
    }
 
    // get maximal logL
    auto logL_max = logL[0];
    for (auto x : logL) {
      if (x > logL_max) logL_max = x;
    }
 
    // calculate probabilities, normalizaton is not needed
    std::vector<double> probability(logL.size());
    for (unsigned i = 0; i < logL.size(); ++i) {
      probability[i] = exp(logL[i] - logL_max) * priors[i];
    }
 
    // find most probable
    unsigned i0 = 0;
    for (unsigned i = 0; i < probability.size(); ++i) {
      if (probability[i] > probability[i0]) i0 = i;
    }
    return Const::chargedStableSet.at(i0);
 
  }

getReferenceTiming()

void getReferenceTiming ( )

private

Find reference timing.

In case that the waveform analysis is enabled, try to find a pair of calibration pulses and timing of the first one is used as reference timing for the correcponding asic. If not enabled, feature extracted timing for a calibration channel is used.

Definition at line 339 of file TOPInterimFENtupleModule.cc.

  {
    static short globalRefAsic = m_globalRefAsicNum + 100 * m_globalRefSlotNum;
    m_globalRefTime = -99999;
    std::map<short, short> iRefHitMap;
    for (int iHit = 0 ; iHit < m_nHit ; iHit++) {
      if (!m_isCalCh[iHit]) continue;
      short reducedPixelId = (m_pixelId[iHit] - 1) / 8 + 100 * m_slotNum[iHit];
      if (iRefHitMap.count(reducedPixelId) > 0) continue;
 
      if (!m_useDoublePulse) {
        iRefHitMap[reducedPixelId] = iHit;
        continue;
      }
 
      std::vector<short> iHitVec;
      iHitVec.push_back(iHit);
      for (int jHit = iHit + 1 ; jHit < m_nHit ; jHit++) {
        short jReducedPixelId = (m_pixelId[jHit] - 1) / 8 + 100 * m_slotNum[jHit];
        if (m_isCalCh[jHit] && jReducedPixelId == reducedPixelId) iHitVec.push_back(jHit);
      }
 
      int nCands = 0;
      for (unsigned int iVec = 0 ; iVec < iHitVec.size() ; iVec++) {
        int jHit = iHitVec[iVec];
        for (unsigned int jVec = iVec + 1 ; jVec < iHitVec.size() ; jVec++) {
          int kHit = iHitVec[jVec];
          float timediff = m_time[kHit] - m_time[jHit];
          if (m_height[jHit] > m_calibrationPulseThreshold1
              && m_height[kHit] > m_calibrationPulseThreshold2
              && TMath::Abs(timediff - m_calibrationPulseInterval) < m_calibrationPulseIntervalRange) {
            if (nCands == 0) {
              iRefHitMap[reducedPixelId] = jHit;
              m_hitQuality[jHit] += 100;
              m_hitQuality[kHit] += 200;
            }
            nCands++;
          }
          //in case jHit and kHit are not in time order (added at 28th Nov)
          else if (timediff < 0 &&  m_height[kHit] > m_calibrationPulseThreshold1
                   && m_height[jHit] > m_calibrationPulseThreshold2
                   && TMath::Abs(timediff + m_calibrationPulseInterval) < m_calibrationPulseIntervalRange) {
            if (nCands == 0) {
              iRefHitMap[reducedPixelId] = kHit;
              m_hitQuality[kHit] += 100;
              m_hitQuality[jHit] += 200;
            }
            nCands++;
          }//satisfy selection criteria for calibration signal
        }
      }//iVec (finish selecting a calibration signal candidate)
    }
 
 
    //loop all hits again to fill the array "refTime"
    for (int iHit = 0 ; iHit < m_nHit ; iHit++) {
      short reducedPixelId = (m_pixelId[iHit] - 1) / 8 + 100 * m_slotNum[iHit];
      if (iRefHitMap.count(reducedPixelId) > 0) {
        int iRef = iRefHitMap[reducedPixelId];
        m_refTime[iHit] = m_time[iRef];
        if (reducedPixelId == globalRefAsic) m_globalRefTime = m_time[iRef];
        if (!m_isReallyJunk[iHit] && m_hitQuality[iRef] >= 100) {
          m_hitQuality[iHit] += 10;
        }
      } else m_refTime[iHit] = -99999;
    }
 
    return;
  }

getTimeOffset()

TOPDigitizerModule::TimeOffset getTimeOffset ( double  trgOffset, int  moduleID, int  pixelID  )

private

Returns a complete time offset by adding time mis-calibration to trgOffset.

Parameters

trgOffset	trigger related time offset
moduleID	slot ID
pixelID	pixel ID

Returns

time offset and its error squared

Definition at line 496 of file TOPDigitizerModule.cc.

  {
    double timeOffset = trgOffset;
    double calErrorSq = 0;
    int winShift = 0;
    double timeShift = 0;
    if (m_useDatabase) {
      const auto& channelMapper = TOPGeometryPar::Instance()->getChannelMapper();
      auto channel = channelMapper.getChannel(pixelID);
      if (m_channelT0->isCalibrated(moduleID, channel)) {
        timeOffset += m_channelT0->getT0(moduleID, channel);
        double err = m_channelT0->getT0Error(moduleID, channel);
        calErrorSq += err * err;
      }
      auto asic = channel / 8;
      if (m_asicShift->isCalibrated(moduleID, asic)) {
        timeOffset += m_asicShift->getT0(moduleID, asic);
        winShift = lround(m_asicShift->getT0(moduleID, asic) / m_syncTimeBase * 2);
        timeShift = winShift * m_syncTimeBase / 2;
      }
      if (m_moduleT0->isCalibrated(moduleID)) {
        timeOffset += m_moduleT0->getT0(moduleID);
        double err = m_moduleT0->getT0Error(moduleID);
        calErrorSq += err * err;
      }
      if (m_commonT0->isCalibrated()) {
        timeOffset += m_commonT0->getT0();
        double err = m_commonT0->getT0Error();
        calErrorSq += err * err;
      }
    }
    return TimeOffset(timeOffset, calErrorSq, winShift, timeShift);
  }

getTimeSeed()

TOPBunchFinderModule::TimeSeed getTimeSeed ( )

private

Returns a time seed.

Returns

time seed

Definition at line 643 of file TOPBunchFinderModule.cc.

  {
    TimeSeed timeSeed; // default time seed; sigma == 0 signals that the seed is not given
 
    if (m_HLTmode) return timeSeed;
    if (m_autoRange) return timeSeed;
    if (not m_useTimeSeed) return timeSeed;
    if (not m_eventT0Offset.isValid()) return timeSeed;
 
    for (auto detector : {Const::SVD, Const::CDC}) {
      if (m_eventT0Offset->isAvailable(detector) and m_eventT0->hasTemporaryEventT0(detector)) {
        auto eventT0s = m_eventT0->getTemporaryEventT0s(detector);
        if (eventT0s.empty()) continue;
        if (detector == Const::CDC and eventT0s.back().algorithm != "chi2") continue;
        double t0 = eventT0s.back().eventT0;
        if (std::abs(t0) > m_timeRangeCoarse / 2) continue;
        timeSeed.t0 = m_isMC ? t0 : t0 - m_eventT0Offset->get(detector).offset;
        timeSeed.sigma = m_eventT0Offset->get(detector).sigma;
        timeSeed.detector = detector;
        break;
      }
    }
 
    return timeSeed;
  }

initialize() [1/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 90 of file OpticalGunModule.cc.

  {
    // data store objects registration
    m_MCParticles.registerInDataStore();
    m_simCalPulses.isOptional();
 
    // parameters check
    if (m_wavelength < 150 or m_wavelength > 1000)
      B2FATAL("Wavelength does not correspond to optical photons.");
    if (m_na < 0 or m_na > 1)
      B2FATAL("Numerical aperture must be between 0 and 1.");
    if (m_minAlpha < 0)
      B2FATAL("Minimum emission angle must be positive");
    if (m_maxAlpha < 0)
      B2FATAL("Maximum emission angle must be positive");
    if (m_minAlpha >= m_maxAlpha)
      B2FATAL("Minimum emission angle must me smaller than the maximum emission angle");
 
    if (m_angularDistribution == string("uniform") or
        m_angularDistribution == string("Lambertian") or
        m_angularDistribution == string("Gaussian"))
      B2INFO("Using the  pre-defined angular distribution " << m_angularDistribution);
    else {
      B2INFO(m_angularDistribution << " is not a pre-defined distribution. "
             << "Checking if it's a valid, positively-defined TFormula.");
      TFormula testFormula("testFormula", m_angularDistribution.c_str());
      int result = testFormula.Compile();
      if (result != 0) {
        B2FATAL(m_angularDistribution << " TFormula does not compile.");
      }
      double testPoint = m_minAlpha; // let's test if the function is postive defined everywhere
      while (testPoint < m_maxAlpha) {
        double value = testFormula.Eval(testPoint * Unit::deg);
        if (value < 0) {
          B2FATAL("The formula " << m_angularDistribution << " is not positively defined at the test point "
                  << testPoint << " deg (value = " << value << ")");
        }
        testPoint += (m_maxAlpha - m_minAlpha) / 100.;
      }
      m_customDistribution = new TF1("m_customDistribution", m_angularDistribution.c_str(), m_minAlpha * Unit::deg,
                                     m_maxAlpha * Unit::deg);
    }
 
    // set other private variables
    m_cosMinAlpha = cos(m_minAlpha * Unit::deg);
    m_cosMaxAlpha = cos(m_maxAlpha * Unit::deg);
    m_energy = TOPGeometryPar::c_hc / m_wavelength * Unit::eV;
 
    EulerAngles ea(-m_phi * Unit::deg, -m_theta * Unit::deg, -m_psi * Unit::deg); // rotation of an object as in TRotation
    m_transform = Transform3D(Rotation3D(ea), Translation3D(m_x, m_y, m_z)); // source positioning and elevation
    if (m_slotID != 0) {
      const auto* geo = TOPGeometryPar::Instance()->getGeometry();
      if (not geo->isModuleIDValid(m_slotID)) B2FATAL("Slot ID is not valid");
      const auto& T = geo->getModule(m_slotID).getTransformation(); // slot to BelleII
      m_transform = T * m_transform;
    }
 
  }

initialize() [2/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 87 of file TOPAlignerModule.cc.

  {
    // check if target module ID is valid
 
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    if (not geo->isModuleIDValid(m_targetMid)) {
      B2ERROR("Target module ID = " << m_targetMid << " is invalid.");
    }
 
    // check if sample type is valid
 
    if (not(m_sample == "dimuon" or m_sample == "bhabha" or m_sample == "cosmics")) {
      B2ERROR("Invalid sample type '" << m_sample << "'");
    }
    if (m_sample == "bhabha") m_chargedStable = Const::electron;
 
    // set track selector
 
    m_selector = TrackSelector(m_sample);
    m_selector.setMinMomentum(m_minMomentum);
    m_selector.setDeltaEcms(m_deltaEcms);
    m_selector.setCutOnPOCA(m_dr, m_dz);
    m_selector.setCutOnLocalZ(m_minZ, m_maxZ);
 
    // set alignment object
 
    m_align.setModuleID(m_targetMid);
    m_align.setSteps(m_stepPosition, m_stepAngle, m_stepTime);
    m_align.setParameters(m_parInit);
    for (const auto& parName : m_parFixed) {
      m_align.fixParameter(parName);
    }
 
    // input
 
    m_digits.isRequired();
    m_tracks.isRequired();
    m_extHits.isRequired();
    m_recBunch.isOptional();
 
    // open output file
 
    m_file = TFile::Open(m_outFileName.c_str(), "RECREATE");
    if (m_file->IsZombie()) {
      B2FATAL("Couldn't open file '" << m_outFileName << "' for writing!");
      return;
    }
 
    // create output tree
 
    m_alignTree = new TTree("alignTree", "TOP alignment results");
    m_alignTree->Branch("ModuleId", &m_targetMid);
    m_alignTree->Branch("iter", &m_iter);
    m_alignTree->Branch("ntrk", &m_ntrk);
    m_alignTree->Branch("errorCode", &m_errorCode);
    m_alignTree->Branch("iterPars", &m_vAlignPars);
    m_alignTree->Branch("iterParsErr", &m_vAlignParsErr);
    m_alignTree->Branch("valid", &m_valid);
    m_alignTree->Branch("numPhot", &m_numPhot);
    m_alignTree->Branch("x", &m_x);
    m_alignTree->Branch("y", &m_y);
    m_alignTree->Branch("z", &m_z);
    m_alignTree->Branch("p", &m_p);
    m_alignTree->Branch("theta", &m_theta);
    m_alignTree->Branch("phi", &m_phi);
    m_alignTree->Branch("r_poca", &m_pocaR);
    m_alignTree->Branch("z_poca", &m_pocaZ);
    m_alignTree->Branch("x_poca", &m_pocaX);
    m_alignTree->Branch("y_poca", &m_pocaY);
    m_alignTree->Branch("Ecms", &m_cmsE);
    m_alignTree->Branch("charge", &m_charge);
    m_alignTree->Branch("PDG", &m_PDG);
 
  }

initialize() [3/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 116 of file TOPBackgroundModule.cc.

  {
 
    // CPU time start
 
    // Initializing the output root file
    m_rootFile = TFile::Open(m_OutputFileName.c_str(), "RECREATE");
    origingamma = new TTree("origingamma", "tree");
    originpe = new TTree("originpe", "tree2");
 
    origingamma->Branch("x", &origingamma_x);
    origingamma->Branch("y", &origingamma_y);
    origingamma->Branch("z", &origingamma_z);
    originpe->Branch("x", &originpe_x);
    originpe->Branch("y", &originpe_y);
    originpe->Branch("z", &originpe_z);
 
    peflux = new TH1F("Photoelectron flux", "Photoelectron flux", 33, -11.25, 360);
    nflux = new TH1F("Neutron flux", "Neutron flux", 33, -11.25, 360);
    rdose = new TH1F("Radiation dose", "Radiation dose", 33, -11.25, 360);
    zdist = new TH1F("Photoelectron origin", "Photoelectron origin", 200, -400, 400);
    genergy = new TH1F("Energy distribution of photons", "Energy distribution of photons", 150, 0, 5);
    genergy2 = new TH1F("Energy distribution of gammas", "Energy distribution of gammas", 500, 0, 5);
 
    zdistg = new TH1F("Photoelectron flux z", "Photoelectron flux Z projection", 800, -400, 400);
    originpt = new TH1F("P_t of origin electron", "P_t of origin electron", 300, 0.06, 0.14);
 
    nflux_bar = new TH2F("Neutron flux on bar", "Neutron flux on bar", 32, -114.8, 211.5, 16, -0, 360);
    gflux_bar = new TH2F("Gamma flux on bar", "Gamma flux on bar MHz/cm^{2}", 32, -114.8, 211.5, 16, -0, 360);
    cflux_bar = new TH2F("Charged flux on bar", "Charged flux on bar MHz/cm^{2}", 32, -114.8, 211.5, 16, -0, 360);
 
    norigin = new TH1F("neutron(BAR) origin", "neutron(BAR) origin", 200, -400, 400);
    gorigin = new TH1F("gamma(BAR) origin", "gamma(BAR) origin", 200, -400, 400);
    corigin = new TH1F("charged(BAR) origin", "charged(BAR) origin", 200, -400, 400);
 
    nprim = new TH1F("neutron(BAR) primary", "neutron(BAR) primary", 200, -400, 400);
    gprim = new TH1F("gamma(BAR) primary", "gamma(BAR) primary", 200, -400, 400);
    cprim = new TH1F("charged(BAR) primary", "charged(BAR) primary", 200, -400, 400);
 
    origin_zx = new TGraph();
    origin_zy = new TGraph();
 
    prim_zx = new TGraph();
    prim_zy = new TGraph();
    module_occupancy = new TGraph();
 
    origin_zy->SetName("originZY");
    origin_zx->SetName("originZX");
    module_occupancy->SetName("occupancy");
 
    const auto& geo = TOP::TOPGeometryPar::Instance()->getGeometry()->getFrontEnd();
    double S1 = geo.getFrontBoardWidth() * geo.getFrontBoardHeight();
    double S2 = geo.getHVBoardWidth() * geo.getHVBoardLength();
    double V1 = S1 * geo.getFrontBoardThickness();
    double V2 = S2 * geo.getHVBoardThickness();
    G4Material* material1 = geometry::Materials::get(geo.getFrontBoardMaterial());
    if (!material1) B2FATAL("Material '" << geo.getFrontBoardMaterial() << "' not found");
    G4Material* material2 = geometry::Materials::get(geo.getHVBoardMaterial());
    if (!material2) B2FATAL("Material '" << geo.getHVBoardMaterial() << "' not found");
    double density1 = material1->GetDensity() / CLHEP::kg * CLHEP::cm * CLHEP::cm * CLHEP::cm;
    double density2 = material2->GetDensity() / CLHEP::kg * CLHEP::cm * CLHEP::cm * CLHEP::cm;
 
    PCBarea = S1 + S2; // [cm^2], old value was: 496.725
    PCBmass = V1 * density1 + V2 * density2; // [kg], old value was: 0.417249
 
    yearns = 1.e13;
    evtoJ = 1.60217653 * 1e-10;
    mtoc = 1.97530864197531;
    count = 0;
    count_occ = 0;
 
    origingamma_x = 0;
    origingamma_y = 0;
    origingamma_z = 0;
    originpe_x = 0;
    originpe_y = 0;
    originpe_z = 0;
  }

initialize() [4/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 111 of file TOPBunchFinderModule.cc.

  {
    // input collections
 
    m_topDigits.isRequired();
    m_topRawDigits.isOptional();
    m_tracks.isRequired();
    StoreArray<ExtHit> extHits;
    extHits.isRequired();
    m_initialParticles.isOptional();
 
    if (m_useMCTruth) {
      StoreArray<MCParticle> mcParticles;
      mcParticles.isRequired();
      StoreArray<TOPBarHit> barHits;
      barHits.isRequired();
    } else {
      if (m_usePIDLikelihoods) {
        StoreArray<PIDLikelihood> pidLikelihoods;
        pidLikelihoods.isRequired();
      } else {
        StoreArray<CDCDedxLikelihood> cdcDedxLikelihoods;
        cdcDedxLikelihoods.isRequired();
        StoreArray<VXDDedxLikelihood> vxdDedxLikelihoods;
        vxdDedxLikelihoods.isOptional();
      }
    }
 
    // output
 
    m_recBunch.registerInDataStore();
    m_timeZeros.registerInDataStore();
    m_timeZeros.registerRelationTo(extHits);
    m_eventT0.registerInDataStore(); // usually it is already registered in tracking
 
    // bunch separation in time
 
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    m_bunchTimeSep = geo->getNominalTDC().getSyncTimeBase() / m_bunchesPerSSTclk;
 
    // prior probabilities: from generic BBbar simulation
    // - MCParticles with reconstructed track and at least 5 detected Cherenkov photons
 
    m_priors[11] =   0.062;  // electrons
    m_priors[13] =   0.086;  // muons
    m_priors[211] =  0.734;  // pions
    m_priors[321] =  0.106;  // kaons
    m_priors[2212] = 0.013;  // protons
    m_priors[1000010020] = 0; // deuterons
 
    double s = 0;
    for (const auto& prior : m_priors) s += prior.second;
    for (auto& prior : m_priors) prior.second /= s;
 
    if (not m_commonT0.isValid()) {
      B2ERROR("Common T0 calibration payload requested but not available");
      return;
    }
 
    /*************************************************************************
     * auto detection of HLT/express reco mode via status of common T0 payload:
     *   c_Default           -> HLT/express reco mode
     *   c_Calibrated        -> data processing mode
     *   c_Unusable          -> HLT/express reco mode
     *   c_roughlyCalibrated -> HLT/express reco mode
     *************************************************************************/
 
    if (m_commonT0->isCalibrated()) {
      m_HLTmode = false;
      m_runningOffset = 0; // since digits are already commonT0 calibrated
      m_runningError = m_commonT0->getT0Error();
    } else if (m_commonT0->isRoughlyCalibrated()) {
      m_HLTmode = true;
      m_runningOffset = m_commonT0->getT0(); // since digits are not commonT0 calibrated
      m_runningError = m_commonT0->getT0Error();
    } else {
      m_HLTmode = true;
      m_runningOffset = 0;
      m_runningError = m_bunchTimeSep / sqrt(12.0);
    }
 
    if (m_HLTmode) {
      m_nTrackLimit = 0;  // use single particle hypothesis to save execution time
      B2INFO("TOPBunchFinder: running in HLT/express reco mode");
    } else {
      B2INFO("TOPBunchFinder: running in data processing mode");
    }
 
  }

initialize() [5/33]

void initialize ( void  )

overridevirtual

initialize method: registers datastore objects (the TOP hits)

Reimplemented from Module.

Definition at line 47 of file TOPChannelMaskerModule.cc.

  {
    // register data objects
    m_digits.isRequired();
    m_eventAsicMask.isOptional();
  }

initialize() [6/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 76 of file TOPChannelT0CalibratorModule.cc.

  {
    // input collections
    m_digits.isRequired();
    m_tracks.isRequired();
    m_extHits.isRequired();
    m_recBunch.isOptional();
 
    // Parse PDF option
    if (m_pdfOption == "rough") {
      m_PDFOption = PDFConstructor::c_Rough;
    } else if (m_pdfOption == "fine") {
      m_PDFOption = PDFConstructor::c_Fine;
    } else if (m_pdfOption == "optimal") {
      m_PDFOption = PDFConstructor::c_Optimal;
    } else {
      B2ERROR("TOPPDFDebuggerModule: unknown PDF option '" << m_pdfOption << "'");
    }
 
    // set track selector
    m_selector = TrackSelector(m_sample);
    m_selector.setMinMomentum(m_minMomentum);
    m_selector.setDeltaEcms(m_deltaEcms);
    m_selector.setCutOnPOCA(m_dr, m_dz);
    m_selector.setCutOnLocalZ(m_minZ, m_maxZ);
 
    // minimum finders
    double tmin = -m_timeRange / 2;
    double tmax =  m_timeRange / 2;
    for (unsigned i = 0; i < 2; i++) {
      for (unsigned m = 0; m < c_numModules; m++) {
        for (unsigned c = 0; c < c_numChannels; c++) {
          m_finders[i][m][c] = Chi2MinimumFinder1D(m_numBins, tmin, tmax);
        }
      }
    }
 
    // if file name includes *'s replace them with a run number
    auto pos = m_outFileName.find("*");
    if (pos != std::string::npos) {
      StoreObjPtr<EventMetaData> evtMetaData;
      auto run = std::to_string(evtMetaData->getRun());
      while (run.size() < 5) run = "0" + run;
      while (pos != std::string::npos) {
        m_outFileName.replace(pos, 1, run);
        pos = m_outFileName.find("*");
      }
    }
 
    // open root file for ntuple and histogram output
    m_file = TFile::Open(m_outFileName.c_str(), "RECREATE");
    if (not m_file) {
      B2ERROR("Cannot open output file '" << m_outFileName << "'");
      return;
    }
 
    // histograms
    for (unsigned module = 0; module < c_numModules; module++) {
      int moduleID = module + 1;
 
      std::string slotNum = std::to_string(moduleID);
      if (moduleID < 10) slotNum = "0" + slotNum;
 
      std::string name = "numHits_slot" + slotNum;
      std::string title = "Number of hits per channel for slot " + slotNum;
      TH1F h1(name.c_str(), title.c_str(), c_numChannels, 0, c_numChannels);
      h1.SetXTitle("channel number");
      h1.SetYTitle("hits per channel");
      m_hits1D.push_back(h1);
 
      name = "timeHits_slot" + slotNum;
      title = "hit time vs. channel for slot " + slotNum;
      TH2F h2(name.c_str(), title.c_str(), c_numChannels, 0, c_numChannels,
              200, 0.0, 20.0);
      h2.SetXTitle("channel number");
      h2.SetYTitle("time [ns]");
      m_hits2D.push_back(h2);
    }
 
    // create output tree
 
    m_tree = new TTree("tree", "Channel T0 calibration results");
    m_tree->Branch("slot", &m_moduleID);
    m_tree->Branch("numPhotons", &m_numPhotons);
    m_tree->Branch("x", &m_x);
    m_tree->Branch("y", &m_y);
    m_tree->Branch("z", &m_z);
    m_tree->Branch("p", &m_p);
    m_tree->Branch("theta", &m_theta);
    m_tree->Branch("phi", &m_phi);
    m_tree->Branch("r_poca", &m_pocaR);
    m_tree->Branch("z_poca", &m_pocaZ);
    m_tree->Branch("x_poca", &m_pocaX);
    m_tree->Branch("y_poca", &m_pocaY);
    m_tree->Branch("Ecms", &m_cmsE);
    m_tree->Branch("charge", &m_charge);
    m_tree->Branch("PDG", &m_PDG);
 
  }

initialize() [7/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 56 of file TOPChannelT0MCModule.cc.

  {
 
    m_digits.isRequired();
 
  }

initialize() [8/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 73 of file TOPCommonT0CalibratorModule.cc.

  {
    // input collections
    m_digits.isRequired();
    m_tracks.isRequired();
    m_extHits.isRequired();
    m_recBunch.isOptional();
 
    // bunch separation in time
 
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    m_bunchTimeSep = geo->getNominalTDC().getSyncTimeBase() / 24;
 
    // Parse PDF option
    if (m_pdfOption == "rough") {
      m_PDFOption = PDFConstructor::c_Rough;
    } else if (m_pdfOption == "fine") {
      m_PDFOption = PDFConstructor::c_Fine;
    } else if (m_pdfOption == "optimal") {
      m_PDFOption = PDFConstructor::c_Optimal;
    } else {
      B2ERROR("TOPPDFDebuggerModule: unknown PDF option '" << m_pdfOption << "'");
    }
 
    // set track selector
    m_selector = TrackSelector(m_sample);
    m_selector.setMinMomentum(m_minMomentum);
    m_selector.setDeltaEcms(m_deltaEcms);
    m_selector.setCutOnPOCA(m_dr, m_dz);
    m_selector.setCutOnLocalZ(m_minZ, m_maxZ);
 
    // Chi2 minimum finders
    double tmin = -m_timeRange / 2;
    double tmax =  m_timeRange / 2;
    for (unsigned i = 0; i < c_numSets; i++) {
      m_finders[i] = Chi2MinimumFinder1D(m_numBins, tmin, tmax);
    }
 
    // if file name includes *'s replace them with a run number
    auto pos = m_outFileName.find("*");
    if (pos != std::string::npos) {
      StoreObjPtr<EventMetaData> evtMetaData;
      auto run = std::to_string(evtMetaData->getRun());
      while (run.size() < 5) run = "0" + run;
      while (pos != std::string::npos) {
        m_outFileName.replace(pos, 1, run);
        pos = m_outFileName.find("*");
      }
    }
 
    // open root file for ntuple and histogram output
    m_file = TFile::Open(m_outFileName.c_str(), "RECREATE");
    if (not m_file) {
      B2ERROR("Cannot open output file '" << m_outFileName << "'");
      return;
    }
 
    // control histograms
    m_hits1D = TH1F("numHits", "Number of photons per slot",
                    c_numModules, 0.5, static_cast<float>(c_numModules) + 0.5);
    m_hits1D.SetXTitle("slot number");
    m_hits1D.SetYTitle("hits per slot");
 
    m_hits2D = TH2F("timeHits", "Photon times vs. boardstacks",
                    c_numModules * 4, 0.5, static_cast<float>(c_numModules) + 0.5, 200, 0.0, 20.0);
    m_hits2D.SetXTitle("slot number");
    m_hits2D.SetYTitle("time [ns]");
 
    // create output tree
    m_tree = new TTree("tree", "Channel T0 calibration results");
    m_tree->Branch("slot", &m_moduleID);
    m_tree->Branch("numPhotons", &m_numPhotons);
    m_tree->Branch("x", &m_x);
    m_tree->Branch("y", &m_y);
    m_tree->Branch("z", &m_z);
    m_tree->Branch("p", &m_p);
    m_tree->Branch("theta", &m_theta);
    m_tree->Branch("phi", &m_phi);
    m_tree->Branch("r_poca", &m_pocaR);
    m_tree->Branch("z_poca", &m_pocaZ);
    m_tree->Branch("x_poca", &m_pocaX);
    m_tree->Branch("y_poca", &m_pocaY);
    m_tree->Branch("Ecms", &m_cmsE);
    m_tree->Branch("charge", &m_charge);
    m_tree->Branch("PDG", &m_PDG);
 
  }

initialize() [9/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 78 of file TOPCosmicT0FinderModule.cc.

  {
    // input
 
    StoreArray<TOPDigit> topDigits;
    topDigits.isRequired();
 
    StoreArray<Track> tracks;
    tracks.isRequired();
 
    StoreArray<ExtHit> extHits;
    extHits.isRequired();
 
    StoreArray<TOPBarHit> barHits;
    barHits.isOptional();
 
    // output
 
    StoreArray<TOPTimeZero> timeZeros;
    timeZeros.registerInDataStore();
    timeZeros.registerRelationTo(tracks);
    timeZeros.registerRelationTo(extHits);
    timeZeros.registerRelationTo(barHits);
  }

initialize() [10/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 103 of file TOPDigitizerModule.cc.

  {
    // input from datastore
    m_simHits.isRequired();
    m_simCalPulses.isOptional();
    m_mcParticles.isOptional();
    m_simClockState.isOptional();
 
    // output to datastore
    m_rawDigits.registerInDataStore();
    m_digits.registerInDataStore();
    m_digits.registerRelationTo(m_simHits);
    m_digits.registerRelationTo(m_mcParticles);
    m_digits.registerRelationTo(m_rawDigits);
    m_waveforms.registerInDataStore(DataStore::c_DontWriteOut);
    m_rawDigits.registerRelationTo(m_waveforms, DataStore::c_Event,
                                   DataStore::c_DontWriteOut);
 
    // geometry and nominal data
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
 
    if (m_electronicJitter < 0) {
      m_electronicJitter = geo->getNominalTDC().getTimeJitter();
    }
 
    // set pile-up and double hit resolution times (needed for BG overlay)
    TOPDigit::setDoubleHitResolution(geo->getNominalTDC().getDoubleHitResolution());
    TOPDigit::setPileupTime(geo->getNominalTDC().getPileupTime());
 
    // default sample times (equidistant)
    m_syncTimeBase = geo->getNominalTDC().getSyncTimeBase();
    m_sampleTimes.setTimeAxis(m_syncTimeBase); // equidistant time base
 
    // default pulse height generator
    m_pulseHeightGenerator = PulseHeightGenerator(m_ADCx0, m_ADCp1, m_ADCp2, m_ADCmax);
 
  }

initialize() [11/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 68 of file TOPTriggerDigitizerModule.cc.

  {
    // input
    StoreArray<TOPRawWaveform> waveforms;
    waveforms.isRequired();
 
    // output
    StoreArray<TOPTriggerDigit> digits;
    digits.registerInDataStore();
    digits.registerRelationTo(waveforms);
    StoreObjPtr<TOPTriggerMCInfo> mcInfo;
    mcInfo.registerInDataStore();
 
    if (m_samplingPhase < 0 or m_samplingPhase >= c_SamplingCycle)
      B2ERROR("samplingPhase must be positive and less than " << c_SamplingCycle);
 
  }

initialize() [12/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 68 of file TOPCalPulseGeneratorModule.cc.

  {
    // Output
 
    m_calPulses.registerInDataStore();
 
    // prepare vectors to loop on
 
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
 
    if (m_moduleIDs.empty()) {
      for (const auto& module : geo->getModules()) {
        m_moduleIDs.push_back(module.getModuleID());
      }
    } else {
      for (auto moduleID : m_moduleIDs) {
        if (!geo->isModuleIDValid(moduleID))
          B2ERROR("Invalid module ID found in input list: " << moduleID);
      }
    }
 
    if (m_asicChannels.empty()) {
      for (unsigned ch = 0; ch < 8; ch++) m_asicChannels.push_back(ch);
    } else {
      for (unsigned ch : m_asicChannels) {
        if (ch > 7)
          B2ERROR("Invalid ASIC channel found in input list: " << ch);
      }
    }
 
  }

initialize() [13/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 90 of file TOPDoublePulseGeneratorModule.cc.

  {
    // Output
 
    StoreArray<TOPDigit> digits;
    digits.registerInDataStore();
 
    // prepare vectors to loop on
 
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
 
    if (m_moduleIDs.empty()) {
      for (const auto& module : geo->getModules()) {
        m_moduleIDs.push_back(module.getModuleID());
      }
    } else {
      for (auto moduleID : m_moduleIDs) {
        if (!geo->isModuleIDValid(moduleID))
          B2ERROR("Invalid module ID found in input list: " << moduleID);
      }
    }
 
    if (m_asicChannels.empty()) {
      for (unsigned ch = 0; ch < 8; ch++) m_asicChannels.push_back(ch);
    } else {
      for (unsigned ch : m_asicChannels) {
        if (ch > 7)
          B2ERROR("Invalid ASIC channel found in input list: " << ch);
      }
    }
 
    // set sample times
 
    double syncTimeBase = geo->getNominalTDC().getSyncTimeBase();
    m_sampleTimes.setTimeAxis(syncTimeBase); // equidistant
    m_sampleDivisions = (0x1 << geo->getNominalTDC().getSubBits());
 
    if (m_useDatabase) {
      m_timebase = new DBObjPtr<TOPCalTimebase>;
    } else if (m_sampleTimeIntervals.empty()) {
      B2INFO("TOPDoublePulseGenerator: using equidistant sample times");
    } else if (m_sampleTimeIntervals.size() == 256) {
      std::vector<double> timeAxis;
      timeAxis.push_back(0);
      for (auto dt : m_sampleTimeIntervals) timeAxis.push_back(dt + timeAxis.back());
      double rescale = 2 * syncTimeBase / timeAxis.back();
      for (auto& t : timeAxis) t *= rescale;
      m_sampleTimes.setTimeAxis(timeAxis, syncTimeBase); // given by steering
      B2INFO("TOPDoublePulseGenerator: using sample times from steering");
    } else {
      B2ERROR("sampleTimeIntervals: size must be 256 or empty");
    }
 
    if (!m_outputFileName.empty()) storeSampleTimes(m_outputFileName);
 
  }

initialize() [14/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

better use isRequired(), but RawFTSW is not in sim

Reimplemented from HistoModule.

Definition at line 258 of file TOPDQMModule.cc.

  {
    // Register histograms (calls back defineHisto)
 
    REG_HISTOGRAM;
 
    // register dataobjects
 
    m_rawFTSW.isOptional(); 
    m_digits.isRequired();
    m_recBunch.isOptional();
    m_timeZeros.isOptional();
    m_tracks.isOptional();
 
  }

initialize() [15/33]

void initialize ( void  )

overridevirtual

Load time vs charge 2D histogram from a given input file (paramter "inputFile") and prepare hit timing and pulse charge distribution for each channel.

Reimplemented from HistoModule.

Definition at line 85 of file TOPGainEfficiencyCalculatorModule.cc.

  {
    REG_HISTOGRAM;
  }

initialize() [16/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from HistoModule.

Definition at line 94 of file TOPLaserHitSelectorModule.cc.

  {
    REG_HISTOGRAM;
 
    StoreArray<TOPDigit> digits;
    digits.isRequired();
  }

initialize() [17/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 53 of file TOPGeometryParInitializerModule.cc.

  {
    auto* gp = TOPGeometryPar::Instance();
    if (gp->isValid()) {
      B2WARNING("TOPGeometryPar has already been initialized");
      return;
    }
 
    if (m_useDB) {
      gp->Initialize();
    } else {
      bool found = false;
      GearDir detectorDir("/Detector");
      for (const GearDir& component : detectorDir.getNodes("DetectorComponent")) {
        if (component.getString("@name") == "TOP") {
          gp->Initialize(GearDir(component, "Content"));
          found = true;
          break;
        }
      }
      if (not found) B2ERROR("Component TOP does not exist or is empty");
    }
 
  }

initialize() [18/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from HistoModule.

Definition at line 80 of file TOPInterimFENtupleModule.cc.

  {
    REG_HISTOGRAM;
 
    StoreArray<RawTOP> rawTOPs;
    rawTOPs.isRequired();
    StoreArray<TOPRawDigit> rawDigits;
    rawDigits.isRequired();
    StoreArray<TOPDigit> digits;
    digits.isRequired();
    StoreArray<TOPInterimFEInfo> infos;
    infos.isRequired();
    StoreArray<TOPProductionEventDebug> prodDebugs;
    prodDebugs.isRequired();
    StoreArray<TOPRawWaveform> waveforms;
    waveforms.isRequired();
  }

initialize() [19/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 75 of file TOPLaserCalibratorModule.cc.

  {
    B2WARNING("You are using an old version of the laser fitter, now deprecated. This module has been superseded by the CAF collector TOPLaserCalibratorCollector and the CAF fitter TOPLocalCalFitter.");
    m_digits.isRequired();
  }

initialize() [20/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 61 of file TOPMCTrackMakerModule.cc.

  {
 
    // input
 
    StoreArray<MCParticle> mcParticles;
    mcParticles.isRequired();
 
    StoreArray<TOPBarHit> barHits;
    barHits.isRequired();
 
    // output
 
    StoreArray<Track> tracks;
    tracks.registerInDataStore();
 
    StoreArray<TrackFitResult> fitResults;
    fitResults.registerInDataStore();
 
    StoreArray<ExtHit> extHits;
    extHits.registerInDataStore();
 
    tracks.registerRelationTo(mcParticles);
    tracks.registerRelationTo(extHits);
 
  }

initialize() [21/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 72 of file TOPModuleT0CalibratorModule.cc.

  {
    // input collections
    m_digits.isRequired();
    m_tracks.isRequired();
    m_extHits.isRequired();
    m_recBunch.isOptional();
 
    // toggle has changed status to prevent warning in beginRun for the first IOV
    m_moduleT0.hasChanged();
 
    // Parse PDF option
    if (m_pdfOption == "rough") {
      m_PDFOption = PDFConstructor::c_Rough;
    } else if (m_pdfOption == "fine") {
      m_PDFOption = PDFConstructor::c_Fine;
    } else if (m_pdfOption == "optimal") {
      m_PDFOption = PDFConstructor::c_Optimal;
    } else {
      B2ERROR("TOPPDFDebuggerModule: unknown PDF option '" << m_pdfOption << "'");
    }
 
    // set track selector
    m_selector = TrackSelector(m_sample);
    m_selector.setMinMomentum(m_minMomentum);
    m_selector.setDeltaEcms(m_deltaEcms);
    m_selector.setCutOnPOCA(m_dr, m_dz);
    m_selector.setCutOnLocalZ(m_minZ, m_maxZ);
 
    // Chi2 minimum finders
    double tmin = -m_timeRange / 2;
    double tmax =  m_timeRange / 2;
    for (unsigned i = 0; i < 2; i++) {
      for (unsigned m = 0; m < c_numModules; m++) {
        m_finders[i][m] = Chi2MinimumFinder1D(m_numBins, tmin, tmax);
      }
    }
 
    // if file name includes *'s replace them with a run number
    auto pos = m_outFileName.find("*");
    if (pos != std::string::npos) {
      StoreObjPtr<EventMetaData> evtMetaData;
      auto run = std::to_string(evtMetaData->getRun());
      while (run.size() < 5) run = "0" + run;
      while (pos != std::string::npos) {
        m_outFileName.replace(pos, 1, run);
        pos = m_outFileName.find("*");
      }
    }
 
    // open root file for ntuple and histogram output
    m_file = TFile::Open(m_outFileName.c_str(), "RECREATE");
    if (not m_file) {
      B2ERROR("Cannot open output file '" << m_outFileName << "'");
      return;
    }
 
    // histograms
    m_hits1D = TH1F("numHits", "Number of photons per slot",
                    c_numModules, 0.5, static_cast<float>(c_numModules) + 0.5);
    m_hits1D.SetXTitle("slot number");
    m_hits1D.SetYTitle("hits per slot");
 
    m_hits2D = TH2F("timeHits", "Photon times vs. boardstacks",
                    c_numModules * 4, 0.5, static_cast<float>(c_numModules) + 0.5, 200, 0.0, 20.0);
    m_hits2D.SetXTitle("slot number");
    m_hits2D.SetYTitle("time [ns]");
 
    // create output tree
    m_tree = new TTree("tree", "Channel T0 calibration results");
    m_tree->Branch("slot", &m_moduleID);
    m_tree->Branch("numPhotons", &m_numPhotons);
    m_tree->Branch("x", &m_x);
    m_tree->Branch("y", &m_y);
    m_tree->Branch("z", &m_z);
    m_tree->Branch("p", &m_p);
    m_tree->Branch("theta", &m_theta);
    m_tree->Branch("phi", &m_phi);
    m_tree->Branch("r_poca", &m_pocaR);
    m_tree->Branch("z_poca", &m_pocaZ);
    m_tree->Branch("x_poca", &m_pocaX);
    m_tree->Branch("y_poca", &m_pocaY);
    m_tree->Branch("Ecms", &m_cmsE);
    m_tree->Branch("charge", &m_charge);
    m_tree->Branch("PDG", &m_PDG);
 
  }

initialize() [22/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 72 of file TOPNtupleModule.cc.

  {
    TDirectory::TContext context;
    m_file = TFile::Open(m_outputFileName.c_str(), "RECREATE");
    if (m_file->IsZombie()) {
      B2FATAL("Couldn't open file '" << m_outputFileName << "' for writing!");
      return;
    }
 
    m_tree = new TTree("top", "TOP validation ntuple");
 
    m_tree->Branch("evt", &m_top.evt, "evt/I");
    m_tree->Branch("run", &m_top.run, "run/I");
 
    m_tree->Branch("p",   &m_top.p,   "p/F");
    m_tree->Branch("cth", &m_top.cth, "cth/F");
    m_tree->Branch("phi", &m_top.phi, "phi/F");
    m_tree->Branch("pValue", &m_top.pValue, "pValue/F");
 
    m_tree->Branch("PDG", &m_top.PDG, "PDG/I");
    m_tree->Branch("motherPDG", &m_top.motherPDG, "motherPDG/I");
    m_tree->Branch("primary", &m_top.primary, "primary/S");
    m_tree->Branch("seen", &m_top.seen, "seen/S");
    m_tree->Branch("rhoProd", &m_top.rhoProd, "rhoProd/F");
    m_tree->Branch("zProd",   &m_top.zProd,   "zProd/F");
    m_tree->Branch("phiProd", &m_top.phiProd, "phiProd/F");
    m_tree->Branch("rhoDec", &m_top.rhoDec, "rhoDec/F");
    m_tree->Branch("zDec",   &m_top.zDec,   "zDec/F");
    m_tree->Branch("phiDec", &m_top.phiDec, "phiDec/F");
    m_tree->Branch("yieldMC", &m_top.yieldMC, "yieldMC/I");
 
    m_tree->Branch("numPhot", &m_top.numPhot, "numPhot/I");
    m_tree->Branch("numBkg", &m_top.numBkg, "numBkg/F");
    m_tree->Branch("moduleID", &m_top.moduleID, "moduleID/I");
    m_tree->Branch("phot",  &m_top.phot,  "e/F:mu:pi:K:p:d");
    m_tree->Branch("yield",  &m_top.yield,  "e/F:mu:pi:K:p:d");
    m_tree->Branch("logL",  &m_top.logL,  "e/F:mu:pi:K:p:d");
 
    m_tree->Branch("extHit",  &m_top.extHit,  "moduleID/I:PDG:x/F:y:z:p:theta:phi:time");
    m_tree->Branch("barHit",  &m_top.barHit,  "moduleID/I:PDG:x/F:y:z:p:theta:phi:time");
 
    StoreArray<Track> tracks;
    tracks.isRequired();
    StoreArray<ExtHit> extHits;
    extHits.isRequired();
    StoreArray<TOPLikelihood> likelihoods;
    likelihoods.isRequired();
    StoreArray<MCParticle> mcParticles;
    mcParticles.isOptional();
    StoreArray<TOPBarHit> barHits;
    barHits.isOptional();
    StoreObjPtr<MCInitialParticles> mcInitialParticles;
    mcInitialParticles.isOptional();
  }

initialize() [23/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 70 of file TOPPackerModule.cc.

  {
 
    if (m_format == "draft") {
      m_dataType = TOP::RawDataType::c_Draft;
      StoreArray<TOPDigit> digits(m_inputDigitsName);
      digits.isRequired();
    } else if (m_format == "FE") {
      m_dataType = TOP::RawDataType::c_Type0Ver16;
      StoreArray<TOPRawDigit> rawDigits(m_inputRawDigitsName);
      rawDigits.isRequired();
    } else if (m_format == "production") {
      m_dataType = TOP::RawDataType::c_ProductionDebug01;
      StoreArray<TOPRawDigit> rawDigits(m_inputRawDigitsName);
      rawDigits.isRequired();
    } else {
      B2ERROR("TOPPacker: unknown data format."
              << LogVar("format", m_format));
    }
 
    StoreArray<RawTOP> rawData(m_outputRawDataName);
    rawData.registerInDataStore();
 
    // check if front end mappings are available
    const auto& mapper = m_topgp->getFrontEndMapper();
    if (!mapper.isValid()) B2ERROR("No front-end mapping available for TOP");
 
  }

initialize() [24/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from HistoModule.

Definition at line 96 of file TOPPDFCheckerModule.cc.

  {
    // Register histograms (calls back defineHisto)
    REG_HISTOGRAM;
 
    // input
 
    m_digits.isRequired();
    m_tracks.isRequired();
 
    StoreArray<ExtHit> extHits;
    extHits.isRequired();
 
    StoreArray<MCParticle> mcParticles;
    mcParticles.isRequired();
 
    StoreArray<TOPBarHit> barHits;
    barHits.isRequired();
 
  }

initialize() [25/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 72 of file TOPPDFDebuggerModule.cc.

  {
    // input
    m_digits.isRequired();
    m_tracks.isRequired();
 
    StoreArray<ExtHit> extHits;
    extHits.isRequired();
 
    StoreArray<MCParticle> mcParticles;
    mcParticles.isOptional();
 
    StoreArray<TOPBarHit> barHits;
    barHits.isOptional();
 
    // output
    m_pdfCollection.registerInDataStore();
    m_tracks.registerRelationTo(m_pdfCollection);
    m_associatedPDFs.registerInDataStore();
    m_digits.registerRelationTo(m_associatedPDFs);
    m_pixelData.registerInDataStore();
    m_tracks.registerRelationTo(m_pixelData);
 
    // particle hypotheses
    if (m_pdgCodes.empty()) {
      for (const auto& part : Const::chargedStableSet) {
        m_chargedStables.push_back(part);
      }
    } else {
      for (auto pdg : m_pdgCodes) {
        auto part = Const::ChargedStable(abs(pdg)); //throws runtime error for invalid pdg
        m_chargedStables.push_back(part);
      }
    }
 
    // Parse PDF option
    if (m_pdfOption == "rough") {
      m_PDFOption = PDFConstructor::c_Rough;
    } else if (m_pdfOption == "fine") {
      m_PDFOption = PDFConstructor::c_Fine;
    } else if (m_pdfOption == "optimal") {
      m_PDFOption = PDFConstructor::c_Optimal;
    } else {
      B2ERROR("TOPPDFDebuggerModule: unknown PDF option '" << m_pdfOption << "'");
    }
 
  }

initialize() [26/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 114 of file TOPRawDigitConverterModule.cc.

  {
 
    // registration of objects in datastore
    m_rawDigits.isRequired(m_inputRawDigitsName);
    m_eventDebugs.isOptional();
    m_digits.registerInDataStore(m_outputDigitsName);
    m_digits.registerRelationTo(m_rawDigits);
    m_asicMask.registerInDataStore();
 
    // equidistant sample times in case calibration is not required
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    m_syncTimeBase = geo->getNominalTDC().getSyncTimeBase();
    m_sampleTimes.setTimeAxis(m_syncTimeBase);
 
  }

initialize() [27/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 69 of file TOPReconstructorModule.cc.

  {
    // input
 
    m_digits.isRequired(m_topDigitCollectionName);
    m_tracks.isRequired();
    m_extHits.isRequired();
    m_barHits.isOptional();
    m_recBunch.isOptional();
 
    // output
 
    m_likelihoods.registerInDataStore(m_topLikelihoodCollectionName);
    m_likelihoods.registerRelationTo(m_extHits);
    m_likelihoods.registerRelationTo(m_barHits);
    m_tracks.registerRelationTo(m_likelihoods);
 
    m_topPulls.registerInDataStore(m_topPullCollectionName, DataStore::c_DontWriteOut);
    m_tracks.registerRelationTo(m_topPulls, DataStore::c_Event, DataStore::c_DontWriteOut);
  }

initialize() [28/33]

void initialize ( void  )

overridevirtual

Initialize the module.

Reimplemented from HistoModule.

Definition at line 336 of file TOPTBCComparatorModule.cc.

  {
    REG_HISTOGRAM;
  }

initialize() [29/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 106 of file TOPTimeBaseCalibratorModule.cc.

  {
 
    // input
    m_digits.isRequired();
 
    // checks
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    if (!geo->isModuleIDValid(m_moduleID))
      B2ERROR("Invalid module ID: " << m_moduleID);
 
    // check for existance and mkdir if not
    if (m_directoryName.empty()) m_directoryName = "./";
    if (m_directoryName != "./") gSystem->mkdir(m_directoryName.c_str(), kTRUE);
 
    // synchronization time corresponding to two ASIC windows
    m_syncTimeBase = geo->getNominalTDC().getSyncTimeBase();
 
    // control histograms
    m_goodHits = TH2F("goodHits", "pulse height vs. pulse width of all good hits",
                      100, 0, 10, 100, 0, 2000);
    m_goodHits.SetXTitle("pulse width (FWHM) [ns]");
    m_goodHits.SetYTitle("pulse height [ADC counts]");
    m_calPulseFirst = TH2F("calPulseFirst",
                           "pulse height vs. pulse width of the first calibration pulse",
                           100, 0, 10, 100, 0, 2000);
    m_calPulseFirst.SetXTitle("pulse width (FWHM) [ns]");
    m_calPulseFirst.SetYTitle("pulse height [ADC counts]");
    m_calPulseSecond = TH2F("calPulseSecond",
                            "pulse height vs. pulse width of the second calibration pulse",
                            100, 0, 10, 100, 0, 2000);
    m_calPulseSecond.SetXTitle("pulse width (FWHM) [ns]");
    m_calPulseSecond.SetYTitle("pulse height [ADC counts]");
 
  }

initialize() [30/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 71 of file TOPTimeRecalibratorModule.cc.

  {
 
    // registration of objects in datastore
    m_digits.isRequired();
    m_recBunch.isRequired();
 
    // equidistant sample times in case calibration is not required
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    m_syncTimeBase = geo->getNominalTDC().getSyncTimeBase();
    m_sampleTimes.setTimeAxis(m_syncTimeBase);
 
  }

initialize() [31/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 82 of file TOPUnpackerModule.cc.

  {
 
    // input
 
    m_rawData.isRequired(m_inputRawDataName);
 
    // output
 
    m_digits.registerInDataStore(m_outputDigitsName);
    m_rawDigits.registerInDataStore(m_outputRawDigitsName);
    m_slowData.registerInDataStore();
    m_interimFEInfos.registerInDataStore(DataStore::c_DontWriteOut);
    m_waveforms.registerInDataStore(m_outputWaveformsName, DataStore::c_DontWriteOut);
    m_productionEventDebugs.registerInDataStore(DataStore::c_DontWriteOut);
    m_productionHitDebugs.registerInDataStore(DataStore::c_DontWriteOut);
    m_templateFitResults.registerInDataStore(m_templateFitResultName, DataStore::c_DontWriteOut);
 
    m_rawDigits.registerRelationTo(m_waveforms, DataStore::c_Event, DataStore::c_DontWriteOut);
    m_rawDigits.registerRelationTo(m_templateFitResults, DataStore::c_Event, DataStore::c_DontWriteOut);
    m_rawDigits.registerRelationTo(m_interimFEInfos, DataStore::c_Event, DataStore::c_DontWriteOut);
    m_rawDigits.registerRelationTo(m_productionHitDebugs, DataStore::c_Event, DataStore::c_DontWriteOut);
    m_waveforms.registerRelationTo(m_interimFEInfos, DataStore::c_Event, DataStore::c_DontWriteOut);
 
    // check if front end mappings are available
    const auto& mapper = m_topgp->getFrontEndMapper();
    int mapSize = mapper.getMapSize();
    if (mapSize == 0) B2ERROR("TOPUnpacker: No front-end mapping available for TOP");
 
  }

initialize() [32/33]

void initialize ( void  )

overridevirtual

Initialize the Module.

This method is called at the beginning of data processing.

Reimplemented from Module.

Definition at line 70 of file TOPWaveformFeatureExtractorModule.cc.

  {
 
    StoreArray<TOPRawDigit> rawDigits(m_inputRawDigitsName);
    rawDigits.isRequired();
 
  }

initialize() [33/33]

void initialize ( void  )

overridevirtual

Module initialization, calls defineHisto and gets waveform.

Reimplemented from HistoModule.

Definition at line 72 of file TOPWaveformQualityPlotterModule.cc.

  {
    // Register histograms (calls back defineHisto)
    REG_HISTOGRAM;
    //Get Waveform from datastore
    m_waveform.isRequired();
  }

isBucketFilled()

bool isBucketFilled ( int  bunchNo )

private

Does reconstructed bunch number correspond to filled bucket.

Parameters

bunchNo

reconstructed relative bunch number

Returns

true if filled

Definition at line 670 of file TOPBunchFinderModule.cc.

  {
    // return true if needed information is not available
 
    if (not m_bunchStructure->isSet()) return true;
    if (m_revo9Counter == 0xFFFF) return true;
 
    // fill pattern offset; it is always zero on MC.
 
    int offset = 0;
    if (not m_isMC) {
      if (not m_fillPatternOffset.isValid()) return true;
      if (not m_fillPatternOffset->isCalibrated()) return true;
      offset = m_fillPatternOffset->get();
    }
 
    // corresponding bucket number and fill status
 
    int RFBuckets = m_bunchStructure->getRFBucketsPerRevolution();
    int bucket = TOPRecBunch::getBucketNumber(bunchNo, m_revo9Counter, offset, RFBuckets);
    bool isFilled = m_bunchStructure->getBucket(bucket);
 
    // store them in TOPRecBunch
 
    m_recBunch->setBucketNumber(bucket);
    m_recBunch->setBucketFillStatus(isFilled);
 
    return isFilled;
  }

isFromThisParticle()

bool isFromThisParticle ( const TOPDigit &  digit, const MCParticle *  particle  )

private

Checks if digit comes from given MC particle.

Parameters

digit	TOP digit
particle	MC particle

Definition at line 207 of file TOPPDFCheckerModule.cc.

  {
    const auto particles = digit.getRelationsWith<MCParticle>();
    for (unsigned i = 0; i < particles.size(); ++i) {
      if (particles[i] == particle and particles.weight(i) > 0) return true;
    }
    return false;
  }

isInsideSlit()

bool isInsideSlit ( const ROOT::Math::XYZPoint &  point, const ROOT::Math::XYZVector &  direction  ) const

private

Checks if photon passes the slit.

Parameters

point	photon emission point
direction	photon emission direction

Returns

true on success

Definition at line 218 of file OpticalGunModule.cc.

  {
    if (m_slitZ < 0.01) return true; // no screen with a slit is put infront of a source
    if (direction.Z() < 1.0e-6) return false; // must fly toward the slit
 
    double pathLength = (m_slitZ - point.Z()) / direction.Z();
    if (m_slitDX > 0) {
      double x = point.X() + pathLength * direction.X();
      if (abs(x - m_slitX0) > m_slitDX / 2.0) return false;
    }
    if (m_slitDY > 0) {
      double y = point.Y() + pathLength * direction.Y();
      if (abs(y - m_slitY0) > m_slitDY / 2.0) return false;
    }
 
    return true;
  }

isRunningOffsetSubtracted() [1/2]

bool isRunningOffsetSubtracted ( )

private

Checks if running offset is subtracted in TOPDigits.

Returns

true if subtracted at least in one digit

Definition at line 305 of file TOPCommonT0CalibratorModule.cc.

  {
    for (const auto& digit : m_digits) {
      if (digit.hasStatus(TOPDigit::c_BunchOffsetSubtracted)) return true;
    }
    return false;
  }

isRunningOffsetSubtracted() [2/2]

bool isRunningOffsetSubtracted ( )

private

Checks if running offset is subtracted in TOPDigits.

Returns

true if subtracted at least in one digit

Definition at line 333 of file TOPModuleT0CalibratorModule.cc.

  {
    for (const auto& digit : m_digits) {
      if (digit.hasStatus(TOPDigit::c_BunchOffsetSubtracted)) return true;
    }
    return false;
  }

Iteration()

void Iteration ( const std::vector< TwoTimes > &  ntuple, std::vector< double > &  xval  )

private

Iteration function called by iterativeTBC()

Parameters

ntuple	ntuple data
xval	TBC constants of 256 samples, time interval is the difference of nearby xvals, xval[0]=0 and xval[256]=2*m_syncTimeBase

Definition at line 623 of file TOPTimeBaseCalibratorModule.cc.

  {
    for (int i = 0; i < c_TimeAxisSize; i++) {
      double wdth = xval[i + 1] - xval[i];
      if (wdth < m_min_binwidth) {
        xval[i] = xval[i] - 0.5 * fabs(wdth) - 0.5 * m_min_binwidth;
        xval[i + 1] = xval[i + 1] + 0.5 * fabs(wdth) + 0.5 * m_min_binwidth;
      }
      if (wdth > m_max_binwidth) {
        xval[i] = xval[i] - 0.5 * fabs(wdth) - 0.5 * m_max_binwidth;
        xval[i + 1] = xval[i + 1] + 0.5 * fabs(wdth) + 0.5 * m_max_binwidth;
      }
    }
 
    if (xval[0] != 0)
      for (int i = 0; i < c_TimeAxisSize; i++)  xval[i] = xval[i] - xval[0];
 
    std::vector<double> xxval(c_TimeAxisSize + 1, 0.0);
    for (int i = 0; i < c_TimeAxisSize + 1; i++)  xxval[i] = xval[i];
 
    double chi2_0 = Chisq(ntuple, xxval);
    if (chi2_0 < 0) B2ERROR("iTBC chisq_0<0! xval has problem.");
 
    std::vector<double> dr_chi2(c_TimeAxisSize + 1, 0.0);
    TH1D hdrsamp_try("hdrsamp_try", "dchi2/dx distribution", 100, -0.01, 0.01);
 
    for (int smp = 1; smp < c_TimeAxisSize; smp++) {
      xxval[smp] = xval[smp] + m_dev_step;
      double chi2_ch = Chisq(ntuple, xxval);
      if (chi2_ch < 0)continue;
      dr_chi2[smp] = (chi2_ch - chi2_0) / m_dev_step;
      hdrsamp_try.Fill(dr_chi2[smp]);
      xxval[smp] = xval[smp];
    }
 
    for (int smp = 1; smp < c_TimeAxisSize; smp++) {
      double vx_it_step = dr_chi2[smp] * m_xstep;
      xval[smp] = xval[smp] - vx_it_step;
    }
 
    //save rms of dchi2/dxval.
    m_dchi2dxv = hdrsamp_try.GetRMS();
    //change m_xstep
    if (fabs(m_dchi2dxv) < m_change_xstep) m_xstep = m_new_xstep;
  }

iterativeTBC()

bool iterativeTBC ( const std::vector< TwoTimes > &  ntuple, unsigned  scrodID, unsigned  scrodChannel, double  meanTimeDifference, TH1F &  Hchi2, TH1F &  Hndf, TH1F &  HDeltaT  )

private

Method by iteration of chi2 minimization.

Parameters

ntuple	ntuple data
scrodID	SCROD ID
scrodChannel	channel number within SCROD (0 - 127)
meanTimeDifference	average time difference [samples]
Hchi2	histogram to store normalized chi^2
Hndf	histogram to store degrees of freedom
HDeltaT	histogram to store fittet double pulse delay

Returns

true on success

Definition at line 538 of file TOPTimeBaseCalibratorModule.cc.

  {
    std::vector<double> xval(c_TimeAxisSize + 1, 0.0);
    double wx = 2 * m_syncTimeBase / static_cast<double>(c_TimeAxisSize);
    for (int i = 0; i < c_TimeAxisSize + 1; i++) xval[i] = i * wx;
 
    B2INFO("TimeBaseCalibration starts for channel#" << chan);
 
    double pre_chi2 = 10000000.0;
    unsigned   num_small_dev = 0;
 
    for (unsigned j = 0; j < m_numIterations; j++) {
 
      Iteration(ntuple, xval);
      double this_chi2 = Chisq(ntuple, xval);
      if (this_chi2 < 0)continue;
      double deltaChi2 = pre_chi2 - this_chi2;
      if (deltaChi2 < -m_dchi2_min) break;
      if (fabs(deltaChi2) < m_deltamin) num_small_dev++;
      if (num_small_dev > m_conv_iter) break;
      pre_chi2 = this_chi2;
    }
 
    // calculate chi^2
 
    double chi2 = Chisq(ntuple, xval);
    Hchi2.SetBinContent(chan + 1, chi2);
    Hndf.SetBinContent(chan + 1, m_good);
 
    // constrain sum of x to 2*syncTimeBase and calculate sample times, not necessary here
 
    double sum = 0;
    for (auto xi : xval) sum += xi;
    if (sum == 0) {
      B2ERROR("sum == 0");
      return false;
    }
 
    double DeltaT = meanTimeDifference * (2 * m_syncTimeBase / static_cast<double>(c_TimeAxisSize));
    HDeltaT.SetBinContent(chan + 1, DeltaT);
 
    std::vector<double> timeInterval;
    for (int i = 0; i < c_TimeAxisSize; i++)timeInterval.push_back(xval[i + 1] - xval[i]);
 
 
    std::vector<double> sampleTimes;
    for (auto xi : xval) sampleTimes.push_back(xi);
 
    // save results as histograms
    std::string forWhat = "scrod " + to_string(scrodID) + " channel " + to_string(chan);
    saveAsHistogram(timeInterval,  "dt_ch" + to_string(chan), "Sample time bins for " + forWhat,
                    "sample number", "#Delta t [ns]");
    saveAsHistogram(sampleTimes, "sampleTimes_ch" + to_string(chan),
                    "Time base corrections for " + forWhat, "sample number", "t [ns]");
 
    // calibrated cal pulse time difference
    std::string name = "timeDiffcal_ch" + to_string(chan);
    std::string title = "Calibrated cal pulse time difference vs. sample for " + forWhat;
    TH2F Hcor(name.c_str(), title.c_str(), c_TimeAxisSize, 0, c_TimeAxisSize,
              100, DeltaT - 0.5, DeltaT + 0.5);
    Hcor.SetXTitle("sample number");
    Hcor.SetYTitle("time difference [ns]");
    Hcor.SetStats(kTRUE);
 
    TOPSampleTimes timeBase;
    timeBase.setTimeAxis(sampleTimes, sampleTimes.back() / 2);
 
    for (const auto& twoTimes : ntuple) {
      if (!twoTimes.good) continue;
      double dt = timeBase.getDeltaTime(0, twoTimes.t2, twoTimes.t1);
      int sample = int(twoTimes.t1) % c_TimeAxisSize;
      Hcor.Fill(sample, dt);
    }
    Hcor.Write();
 
    B2INFO("... channel " << chan << " OK (chi^2/ndf = " << chi2
           << ", ndf = " << m_good << ")");
 
    return true;
  }

LoadHistograms()

void LoadHistograms

(

const std::string &

histotype

)

Load 2D histograms from a given input file (output of TOPLaserHitSelector) and create timing and charge distribution as projection histograms for the x- and y-axis, respectively.

Timing cut is also applied for charge distributiion

Definition at line 218 of file TOPGainEfficiencyCalculatorModule.cc.

  {
 
    TFile* f = new TFile(m_inputFile.c_str());
    if (!f->IsOpen()) {
      B2ERROR("TOPGainEfficiencyCalculator : fail to open input file \"" << m_inputFile << "\"");
      return;
    }
 
    for (int iHisto = 0 ; iHisto < c_NChannelPerPMT ; iHisto++) {
      if (m_targetPmtChId != -1 && iHisto + 1 != m_targetPmtChId) continue;
      std::ostringstream pixelstr;
      pixelstr << histotype << "_"
               << "s" << std::setw(2) << std::setfill('0') << m_targetSlotId << "_PMT"
               << std::setw(2) << std::setfill('0') << m_targetPmtId
               << "_" << std::setw(2) << std::setfill('0') << (iHisto + 1);
      std::ostringstream hname;
      hname << "hTime" << pixelstr.str();
 
      //first get 2D histogram from a given input (=an output file of TOPLaserHitSelector)
      m_timeChargeHistogram[iHisto] = (TH2F*)f->Get(hname.str().c_str());
      TH2F* h2D = m_timeChargeHistogram[iHisto];
      if (!h2D) continue;
 
      //create a projection histogram along the x-axis and fit the distribution (hit timing) to get direct laser hit timing
      std::ostringstream hnameProj[2];
      hnameProj[0] << "hTime_" << pixelstr.str();
      hnameProj[1] << "hCharge_" << pixelstr.str();
      TH1D* hTime = (TH1D*)h2D->ProjectionX(hnameProj[0].str().c_str());
      m_timeHistogram[iHisto] = hTime;
      double peakTime = FindPeakForSmallerXThan(hTime, 0);
      //double peakTime = hTime->GetXaxis()->GetBinCenter(hTime->GetMaximumBin());
      double fitMin = peakTime - m_fitHalfWidth;
      double fitMax = peakTime + m_fitHalfWidth;
      TF1* funcLaser = new TF1(std::string(std::string("func_") + hnameProj[1].str()).c_str(),
                               "gaus(0)", fitMin, fitMax);
      funcLaser->SetParameters(hTime->GetBinContent(hTime->GetXaxis()->FindBin(peakTime)), peakTime, m_fitHalfWidth);
      funcLaser->SetParLimits(1, fitMin, fitMax);
      hTime->Fit(funcLaser, "Q", "", fitMin, fitMax);
      //if (funcLaser->GetNDF() < 1) continue;
      m_funcForLaser[iHisto] = funcLaser;
 
      //if the fitting is successful, create y-projection histogram with timing cut
      m_hitTiming = funcLaser->GetParameter(1);
      int binNumMin = hTime->GetXaxis()->FindBin(m_hitTiming - 2 * m_fitHalfWidth);
      int binNumMax = hTime->GetXaxis()->FindBin(m_hitTiming + 2 * m_fitHalfWidth);
      TH1D* hCharge = (TH1D*)h2D->ProjectionY(hnameProj[1].str().c_str(),
                                              binNumMin, binNumMax);
      m_chargeHistogram[iHisto] = hCharge;
    }
 
    m_nCalPulseHistogram = (TH1F*)f->Get("hNCalPulse");
    if (!m_nCalPulseHistogram)
      B2WARNING("TOPGainEfficiencyCalculator : no histogram for the number of events with calibration pulses identified in the given input file");
    m_thresholdForIntegral = m_threshold * m_p1HeightIntegral + m_p0HeightIntegral;
    return;
  }

makeComparisons()

int makeComparisons

(

)

Last function to be called, compared the histograms of different datasets filled by analyzeCalFile() Every new comparison histogram added to the module has to be filled here.

Definition at line 301 of file TOPTBCComparatorModule.cc.

  {
    // Set to compare with
    short refSet = 0;
    B2INFO("Making comparisons for " << m_totCalSets << " sets.");
 
    // Loop over the sets. Do not make the comparison for the set #0
    for (int iSet = 1; iSet < m_totCalSets; iSet++) {
      if (m_compareToPreviousSet) refSet = iSet - 1;
 
      m_topAverageDeltaTComparison[iSet] = calculateHistoRatio(m_topAverageDeltaTComparison[iSet], m_topAverageDeltaT[iSet],
                                                               m_topAverageDeltaT[refSet]);
      m_topSigmaDeltaTComparison[iSet] = calculateHistoRatio(m_topSigmaDeltaTComparison[iSet], m_topSigmaDeltaT[iSet],
                                                             m_topSigmaDeltaT[refSet]);
      m_topSampleOccupancyComparison[iSet] = calculateHistoRatio(m_topSampleOccupancyComparison[iSet], m_topSampleOccupancy[iSet],
                                                                 m_topSampleOccupancy[refSet]);
 
      // Loop over the sets. Do not make the comparison for the set #0
      for (int iSlot = 0; iSlot < 16; iSlot++) {
        m_slotAverageDeltaTComparison[iSlot][iSet] = calculateHistoRatio(m_slotAverageDeltaTComparison[iSlot][iSet],
                                                     m_slotAverageDeltaT[iSlot][iSet], m_slotAverageDeltaT[iSlot][refSet]);
        m_slotAverageDeltaTMapComparison[iSlot][iSet] = calculateHistoRatio(m_slotAverageDeltaTMapComparison[iSlot][iSet],
                                                        m_slotAverageDeltaTMap[iSlot][iSet], m_slotAverageDeltaTMap[iSlot][refSet]);
        m_slotSigmaDeltaTComparison[iSlot][iSet] = calculateHistoRatio(m_slotSigmaDeltaTComparison[iSlot][iSet],
                                                   m_slotSigmaDeltaT[iSlot][iSet], m_slotSigmaDeltaT[iSlot][refSet]);
        m_slotSigmaDeltaTMapComparison[iSlot][iSet] = calculateHistoRatio(m_slotSigmaDeltaTMapComparison[iSlot][iSet],
                                                      m_slotSigmaDeltaTMap[iSlot][iSet], m_slotSigmaDeltaTMap[iSlot][refSet]);
      }
    }
    B2INFO("Comparisons done");
 
    return 1;
  }

matrixInversion()

bool matrixInversion ( const std::vector< TwoTimes > &  ntuple, unsigned  scrodID, unsigned  scrodChannel, double  meanTimeDifference, TH1F &  Hchi2, TH1F &  Hndf, TH1F &  HDeltaT  )

private

Method by matrix inversion.

Parameters

ntuple	ntuple data
scrodID	SCROD ID
scrodChannel	channel number within SCROD (0 - 127)
meanTimeDifference	average time difference [samples]
Hchi2	histogram to store normalized chi^2
Hndf	histogram to store degrees of freedom
HDeltaT	histogram to store fittet double pulse delay

Returns

true on success

Definition at line 398 of file TOPTimeBaseCalibratorModule.cc.

  {
 
    // Ax = b: construct matrix A and right side vector b
 
    TMatrixDSym A(c_TimeAxisSize);
    vector<double> b(c_TimeAxisSize, 0.0);
 
    for (const auto& twoTimes : ntuple) {
      if (!twoTimes.good) continue;
 
      vector<double> m(c_TimeAxisSize, 0.0);
      int i1 = int(twoTimes.t1);
      m[i1 % c_TimeAxisSize] = 1.0 - (twoTimes.t1 - i1);
      int i2 = int(twoTimes.t2);
      m[i2 % c_TimeAxisSize] = twoTimes.t2 - i2;
      i2 = i1 + (i2 - i1) % c_TimeAxisSize;
      for (int k = i1 + 1; k < i2; k++) m[k % c_TimeAxisSize] = 1;
 
      double relSigma = twoTimes.sigma / meanTimeDifference;
      double sig2 = relSigma * relSigma;
 
      for (int jj = i1; jj < i2 + 1; jj++) {
        int j = jj % c_TimeAxisSize;
        for (int kk = i1; kk < i2 + 1; kk++) {
          int k = kk % c_TimeAxisSize;
          A(j, k) += m[j] * m[k] / sig2;
        }
      }
      for (int k = 0; k < c_TimeAxisSize; k++) b[k] += m[k] / sig2;
    }
 
    // save as histograms
 
    string forWhat = "scrod " + to_string(scrodID) + " channel " + to_string(chan);
    if (m_saveMatrix) {
      saveAsHistogram(A, "matA_ch" + to_string(chan), "Matrix for " + forWhat);
      saveAsHistogram(b, "vecB_ch" + to_string(chan), "Right side for " + forWhat);
    }
 
    // invert matrix A and solve the equation: x = A^{-1}b
 
    double det = 0;
    A.Invert(&det);
    if (det == 0) {
      B2INFO("... channel " << chan << " failed");
      return false;
    }
 
    vector<double> x(c_TimeAxisSize, 0.0);
    for (int k = 0; k < c_TimeAxisSize; k++) {
      for (int j = 0; j < c_TimeAxisSize; j++) {
        x[k] += A(k, j) * b[j];
      }
    }
 
    // calculate chi^2
 
    double chi2 = 0;
    int ndf = -c_TimeAxisSize;
 
    for (const auto& twoTimes : ntuple) {
      if (!twoTimes.good) continue;
 
      vector<double> m(c_TimeAxisSize, 0.0);
      int i1 = int(twoTimes.t1);
      m[i1 % c_TimeAxisSize] = 1.0 - (twoTimes.t1 - i1);
      int i2 = int(twoTimes.t2);
      m[i2 % c_TimeAxisSize] = twoTimes.t2 - i2;
      i2 = i1 + (i2 - i1) % c_TimeAxisSize;
      for (int k = i1 + 1; k < i2; k++) m[k % c_TimeAxisSize] = 1;
      double s = -1.0;
      for (int k = 0; k < c_TimeAxisSize; k++) s += m[k] * x[k];
      double relSigma = twoTimes.sigma / meanTimeDifference;
      double sig2 = relSigma * relSigma;
      chi2 += s * s / sig2;
      ndf++;
    }
    Hchi2.SetBinContent(chan + 1, chi2 / ndf);
    Hndf.SetBinContent(chan + 1, ndf);
 
    // constrain sum of x to 2*syncTimeBase and calculate sample times
 
    double sum = 0;
    for (auto xi : x) sum += xi;
    if (sum == 0) {
      B2ERROR("sum == 0");
      return false;
    }
    double DeltaT = 2 * m_syncTimeBase / sum;
    for (auto& xi : x) xi *= DeltaT;
    HDeltaT.SetBinContent(chan + 1, DeltaT);
 
    vector<double> err;
    for (int k = 0; k < c_TimeAxisSize; k++) err.push_back(sqrt(A(k, k)) * DeltaT);
 
    vector<double> sampleTimes;
    sampleTimes.push_back(0);
    for (auto xi : x) sampleTimes.push_back(xi + sampleTimes.back());
 
    // save results as histograms
 
    if (m_saveMatrix) saveAsHistogram(A, "invA_ch" + to_string(chan), "Inverted matrix for " + forWhat);
    saveAsHistogram(x, err, "dt_ch" + to_string(chan), "Sample time bins for " + forWhat,
                    "sample number", "#Delta t [ns]");
    saveAsHistogram(sampleTimes, "sampleTimes_ch" + to_string(chan),
                    "Time base corrections for " + forWhat, "sample number", "t [ns]");
 
    // calibrated cal pulse time difference
 
    string name = "timeDiffcal_ch" + to_string(chan);
    string title = "Calibrated cal pulse time difference vs. sample for " + forWhat;
    TH2F Hcor(name.c_str(), title.c_str(), c_TimeAxisSize, 0, c_TimeAxisSize,
              100, DeltaT - 0.5, DeltaT + 0.5);
    Hcor.SetXTitle("sample number");
    Hcor.SetYTitle("time difference [ns]");
    Hcor.SetStats(kTRUE);
 
    TOPSampleTimes timeBase;
    timeBase.setTimeAxis(sampleTimes, sampleTimes.back() / 2);
 
    for (const auto& twoTimes : ntuple) {
      if (!twoTimes.good) continue;
      double dt = timeBase.getDeltaTime(0, twoTimes.t2, twoTimes.t1);
      int sample = int(twoTimes.t1) % c_TimeAxisSize;
      Hcor.Fill(sample, dt);
    }
    Hcor.Write();
 
    B2INFO("... channel " << chan << " OK (chi^2/ndf = " << chi2 / ndf
           << ", ndf = " << ndf << ")");
 
    return true;
  }

myprint()

void myprint	(	TH1F *	histo,
		const char *	path,
		const char *	xtit = "",
		const char *	ytit = "",
		double	tresh = 0
	)

Print histogram 1D, helper function.

Definition at line 323 of file TOPBackgroundModule.cc.

  {
 
    gROOT->Reset();
    gStyle->SetOptStat("");
    gStyle->SetOptFit(1111);
 
    gStyle->SetCanvasColor(-1);
    gStyle->SetPadColor(-1);
    gStyle->SetFrameFillColor(-1);
    gStyle->SetHistFillColor(-1);
    gStyle->SetTitleFillColor(-1);
    gStyle->SetFillColor(-1);
    gStyle->SetFillStyle(4000);
    gStyle->SetStatStyle(0);
    gStyle->SetTitleStyle(0);
    gStyle->SetCanvasBorderSize(0);
    gStyle->SetCanvasBorderMode(0);
    gStyle->SetPadBorderMode(0);
    //  gStyle->SetTitleMode(0);
    gStyle->SetFrameBorderSize(0);
    gStyle->SetLegendBorderSize(0);
    gStyle->SetStatBorderSize(0);
    gStyle->SetTitleBorderSize(0);
    //gROOT->ForceStyle();*/
 
 
 
    TCanvas* c1 = new TCanvas("c1", "", 1920, 1200);
 
    double x1 = histo->GetBinLowEdge(1);
    double nb = histo->GetNbinsX();
    double bin = histo->GetBinWidth(1);
    double x2 = x1 + bin * nb;
 
    double max = histo->GetBinContent(histo->GetMaximumBin());
 
    if (max < tresh) {
      histo->GetYaxis()->SetRangeUser(0, tresh * 1.1);
    }
 
    TLine* line = new TLine(x1, tresh, x2, tresh);
    line->SetLineColor(1);
    line->SetLineWidth(3);
    line->SetLineStyle(2);
 
 
    histo->SetFillColor(2);
    histo->SetLineColor(1);
 
    gPad->SetTopMargin(0.08);
    gPad->SetBottomMargin(0.15);
    gPad->SetGridy();
 
    histo->GetXaxis()->SetLabelSize(0.06);
    histo->GetYaxis()->SetLabelSize(0.06);
    histo->GetXaxis()->SetTitleSize(0.06);
    histo->GetYaxis()->SetTitleSize(0.06);
    histo->GetXaxis()->SetTitle(xtit);
    histo->GetYaxis()->SetTitle(ytit);
    histo->GetXaxis()->SetTitleOffset(0.9);
    histo->GetYaxis()->SetTitleOffset(0.7);
 
    histo->Draw();
 
    TLegend* leg = new TLegend(0.75, 0.95, 0.90, 1.00);
    leg->AddEntry(histo, m_BkgType.c_str(), "pf");
    leg->Draw("SAME");
    if (tresh > 0.01) {
      line->Draw("SAME");
    }
 
    c1->Print(path);
  }

OpticalGunModule()

OpticalGunModule

(

)

Constructor.

Definition at line 47 of file OpticalGunModule.cc.

                                     : Module()
  {
    // set module description
    setDescription("Source of optical photons");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("x", m_x, "position in x [cm]", 0.0);
    addParam("y", m_y, "position in y [cm]", 0.0);
    addParam("z", m_z, "position in z [cm]", 0.0);
    addParam("diameter", m_diameter, "source diameter [cm]", 0.0);
    addParam("minAlpha", m_minAlpha, "source minimum emission angle [deg]. ", 0.0);
    addParam("maxAlpha", m_maxAlpha, "source maximum emission angle [deg]. ", 30.);
    addParam("na", m_na, "source numerical aperture. It is used only by the Gaussian distribution", 0.50);
    addParam("angularDistribution", m_angularDistribution,
             "source angular distribution: uniform, Lambertian, an arbitrary TFormula, or  Gaussian "
             "(numerical aperture instead of minAlpha and maxAlpha). If you are writing a TFormula, "
             "assume the angles are measured in degrees. The conversion to radians is done internally.",
             string("Gaussian"));
    addParam("wavelength", m_wavelength, "wavelength of photons [nm]", 405.0);
    addParam("phi", m_phi, "first rotation angle (around z) [deg]", 0.0);
    addParam("theta", m_theta, "second rotation angle (around x) [deg]", 0.0);
    addParam("psi", m_psi, "third rotation angle (around z) [deg]", 0.0);
    addParam("startTime", m_startTime,
             "start time [ns]. If TOPCalPulseGenerator is in path this is relative to the first cal pulse", 0.0);
    addParam("pulseWidth", m_pulseWidth, "pulse duration (Gaussian sigma) [ns]", 0.0);
    addParam("numPhotons", m_numPhotons,
             "average number of photons per pulse, if positive, otherwise exactly one", 0.0);
    addParam("slotID", m_slotID,
             "TOP slot ID (1-16): if valid, source position and rotation angles assumed to be given in a local bar frame, "
             "otherwise Belle II frame is assumed", 0);
    addParam("slitDX", m_slitDX, "slit size in x [cm], if positive, otherwise full open", 0.0);
    addParam("slitDY", m_slitDY, "slit size in y [cm], if positive, otherwise full open", 0.0);
    addParam("slitX0", m_slitX0, "slit x-offset in respect to source [cm] ", 0.0);
    addParam("slitY0", m_slitY0, "slit y-offset in respect to source [cm] ", 0.0);
    addParam("slitZ", m_slitZ, "slit distance to source [cm], if > 0.01, otherwise slit full open", 0.0);
  }

packProductionDebug()

void packProductionDebug ( )

private

Pack in format: Production Debugging Data Format 01.

Definition at line 295 of file TOPPackerModule.cc.

  {
    StoreObjPtr<EventMetaData> evtMetaData;
    StoreArray<TOPRawDigit> digits(m_inputRawDigitsName);
    StoreArray<RawTOP> rawData(m_outputRawDataName);
 
    const auto& mapper = m_topgp->getFrontEndMapper();
    int mapSize = mapper.getMapSize();
    if (mapSize == 0) return;
 
    auto* sortedDigits = new vector<const TOPRawDigit*>[mapSize];
 
    for (const auto& digit : digits) {
      auto scrodID = digit.getScrodID();
      const auto* feemap = mapper.getMap(scrodID);
      if (!feemap) {
        B2ERROR("TOPPacker: no front-end map available."
                << LogVar("scrodID", scrodID));
        continue;
      }
      sortedDigits[feemap->getIndex()].push_back(&digit);
    }
 
    unsigned revo9count = 0;
    unsigned phase = 0;
    if (digits.getEntries() > 0) {
      revo9count = digits[0]->getRevo9Counter();
      phase = digits[0]->getPhase();
    }
 
    for (const auto& copperID : mapper.getCopperIDs()) {
      vector<int> Buffer[4];
      for (int finesse = 0; finesse < 4; finesse++) {
        const auto* feemap = mapper.getMapFromCopper(copperID, finesse);
        if (!feemap) continue;
        unsigned scrodID = feemap->getScrodID();
        unsigned format = static_cast<unsigned>(TOP::RawDataType::c_ProductionDebug01);
 
        unsigned head0 = (format << 16) | (0xA << 12) | (scrodID & 0x0FFF);
        Buffer[finesse].push_back(head0);
 
        unsigned numWordsCore = sortedDigits[feemap->getIndex()].size() * 5 + 1;
        unsigned head1 = ((phase & 0xF) << 12) | (numWordsCore & 0xFFF);
        Buffer[finesse].push_back(head1);
 
        unsigned head2 = revo9count & 0xFFFF;
        Buffer[finesse].push_back(head2);
 
        unsigned head3 = 0;
        Buffer[finesse].push_back(head3);
 
        unsigned Nhits = 0;
        for (const auto& digit : sortedDigits[feemap->getIndex()]) {
          unsigned checkSum = 0; // IPv4 checksum
          unsigned word0 =
            (digit->getCarrierNumber() << 30) |
            ((digit->getASICNumber() & 0x3) << 28) |
            ((digit->getASICChannel() & 0x7) << 25) |
            ((digit->getASICWindow() & 0x1FF) << 16) |
            (0xB << 12) |
            ((digit->getTFine() & 0xF) << 8);
          checkSum += (word0 & 0xFFFF) + ((word0 >> 16) & 0xFFFF);
          Buffer[finesse].push_back(word0);
          unsigned word1 =
            ((digit->getValuePeak() & 0x1FFF) << 16) |
            (digit->getIntegral() & 0xFFFF);
          checkSum += (word1 & 0xFFFF) + ((word1 >> 16) & 0xFFFF);
          Buffer[finesse].push_back(word1);
          unsigned word2 =
            ((digit->getValueRise0() & 0x1FFF) << 16) |
            (digit->getValueRise1() & 0x1FFF);
          checkSum += (word2 & 0xFFFF) + ((word2 >> 16) & 0xFFFF);
          Buffer[finesse].push_back(word2);
          unsigned word3 =
            ((digit->getValueFall0() & 0x1FFF) << 16) |
            (digit->getValueFall1() & 0x1FFF);
          checkSum += (word3 & 0xFFFF) + ((word3 >> 16) & 0xFFFF);
          Buffer[finesse].push_back(word3);
          unsigned word4 =
            (digit->getSampleRise() << 24) |
            ((digit->getDeltaSamplePeak() & 0xF) << 20) |
            ((digit->getDeltaSampleFall() & 0xF) << 16);
          checkSum += (word4 & 0xFFFF) + ((word4 >> 16) & 0xFFFF);
          while ((checkSum >> 16) > 0) {
            checkSum = (checkSum & 0xFFFF) + (checkSum >> 16);
          }
          word4 |= ((~checkSum) & 0xFFFF);
          Buffer[finesse].push_back(word4);
          Nhits++;
        }
        unsigned tail = (0x5 << 9) | (Nhits & 0x1FF);
        Buffer[finesse].push_back(tail);
      }
 
      RawCOPPERPackerInfo info;
      info.exp_num = evtMetaData->getExperiment();
      // run number : 14bits, subrun # : 8bits
      info.run_subrun_num = (evtMetaData->getRun() << 8) +
                            (evtMetaData->getSubrun() & 0xFF);
      info.eve_num = evtMetaData->getEvent();
      info.node_id = TOP_ID + copperID;
      info.tt_ctime = 0;
      info.tt_utime = 0;
      info.b2l_ctime = 0;
      info.hslb_crc16_error_bit = 0;
      info.truncation_mask = 0;
      info.type_of_data = 0;
 
      auto* raw = rawData.appendNew();
      raw->PackDetectorBuf(Buffer[0].data(), Buffer[0].size(),
                           Buffer[1].data(), Buffer[1].size(),
                           Buffer[2].data(), Buffer[2].size(),
                           Buffer[3].data(), Buffer[3].size(),
                           info);
    }
    delete [] sortedDigits;
  }

packProductionDraft()

void packProductionDraft ( )

private

Pack in format: c_Draft (tentative production format) this format was never implemented in firmware!

Definition at line 132 of file TOPPackerModule.cc.

  {
    StoreObjPtr<EventMetaData> evtMetaData;
    StoreArray<TOPDigit> digits(m_inputDigitsName);
    StoreArray<RawTOP> rawData(m_outputRawDataName);
 
    const auto& mapper = m_topgp->getFrontEndMapper();
    int mapSize = mapper.getMapSize();
    if (mapSize == 0) return;
 
    vector<const TOPDigit*>* sortedDigits = new vector<const TOPDigit*>[mapSize];
 
    for (const auto& digit : digits) {
      int moduleID = digit.getModuleID();
      int boardstack = digit.getChannel() / 128;
      const auto* feemap = mapper.getMap(moduleID, boardstack);
      if (!feemap) {
        B2ERROR("TOPPacker: no front-end map available."
                << LogVar("moduleID", moduleID)
                << LogVar("boardstack", boardstack));
        continue;
      }
      sortedDigits[feemap->getIndex()].push_back(&digit);
    }
 
    auto subBits = m_topgp->getGeometry()->getNominalTDC().getSubBits();
    int sampleDivisions = 0x1 << subBits;
 
    for (const auto& copperID : mapper.getCopperIDs()) {
      vector<int> Buffer[4];
      for (int finesse = 0; finesse < 4; finesse++) {
        const auto* feemap = mapper.getMapFromCopper(copperID, finesse);
        if (!feemap) continue;
        unsigned scrodID = feemap->getScrodID();
        unsigned dataFormat = static_cast<unsigned>(TOP::RawDataType::c_Draft);
        Buffer[finesse].push_back(scrodID + (dataFormat << 16));
        for (const auto& digit : sortedDigits[feemap->getIndex()]) {
          double rawTime = digit->getRawTime();
          unsigned tdc = int(rawTime * sampleDivisions) & 0xFFFF;
          unsigned chan = digit->getChannel() % 128;
          unsigned flags = (unsigned) digit->getHitQuality();
          Buffer[finesse].push_back(tdc + (chan << 16) + (flags << 24));
        }
      }
      RawCOPPERPackerInfo info;
      info.exp_num = evtMetaData->getExperiment();
      // run number : 14bits, subrun # : 8bits
      info.run_subrun_num = (evtMetaData->getRun() << 8) +
                            (evtMetaData->getSubrun() & 0xFF);
      info.eve_num = evtMetaData->getEvent();
      info.node_id = TOP_ID + copperID;
      info.tt_ctime = 0;
      info.tt_utime = 0;
      info.b2l_ctime = 0;
      info.hslb_crc16_error_bit = 0;
      info.truncation_mask = 0;
      info.type_of_data = 0;
 
      auto* raw = rawData.appendNew();
      raw->PackDetectorBuf(Buffer[0].data(), Buffer[0].size(),
                           Buffer[1].data(), Buffer[1].size(),
                           Buffer[2].data(), Buffer[2].size(),
                           Buffer[3].data(), Buffer[3].size(),
                           info);
    }
    delete [] sortedDigits;
  }

packType0Ver16()

void packType0Ver16 ( )

private

Pack in format: c_Type0Ver16 (Feature-extracted data) this format was never implemented in firmware!

Definition at line 201 of file TOPPackerModule.cc.

  {
    StoreObjPtr<EventMetaData> evtMetaData;
    StoreArray<TOPRawDigit> digits(m_inputRawDigitsName);
    StoreArray<RawTOP> rawData(m_outputRawDataName);
 
    const auto& mapper = m_topgp->getFrontEndMapper();
    int mapSize = mapper.getMapSize();
    if (mapSize == 0) return;
 
    auto* sortedDigits = new vector<const TOPRawDigit*>[mapSize];
 
    for (const auto& digit : digits) {
      auto scrodID = digit.getScrodID();
      const auto* feemap = mapper.getMap(scrodID);
      if (!feemap) {
        B2ERROR("TOPPacker: no front-end map available."
                << LogVar("scrodID", scrodID));
        continue;
      }
      sortedDigits[feemap->getIndex()].push_back(&digit);
    }
 
    for (const auto& copperID : mapper.getCopperIDs()) {
      vector<int> Buffer[4];
      for (int finesse = 0; finesse < 4; finesse++) {
        const auto* feemap = mapper.getMapFromCopper(copperID, finesse);
        if (!feemap) continue;
        unsigned scrodID = feemap->getScrodID();
        unsigned dataFormat = static_cast<unsigned>(TOP::RawDataType::c_Type0Ver16);
 
        // production data v2.1 (data_format_v2_1.xlsx from Lynn 06/26/2016)
        unsigned head = (dataFormat << 16) | (0xA << 12) | (scrodID & 0x0FFF);
        Buffer[finesse].push_back(head);
        unsigned Nhits = 0;
        for (const auto& digit : sortedDigits[feemap->getIndex()]) {
          unsigned word1 =
            (digit->getCarrierNumber() << 30) |
            ((digit->getASICNumber() & 0x3) << 28) |
            ((digit->getASICChannel() & 0x7) << 25) |
            ((digit->getASICWindow() & 0x1FF) << 16) |
            (0xB << 12) |
            ((digit->getTFine() & 0xF) << 8);
          Buffer[finesse].push_back(word1);
          unsigned word2 =
            ((digit->getValuePeak() & 0x1FFF) << 16) |
            (digit->getIntegral() & 0xFFFF);
          Buffer[finesse].push_back(word2);
          unsigned word3 =
            ((digit->getValueRise0() & 0x1FFF) << 16) |
            (digit->getValueRise1() & 0x1FFF);
          Buffer[finesse].push_back(word3);
          unsigned word4 =
            ((digit->getValueFall0() & 0x1FFF) << 16) |
            (digit->getValueFall1() & 0x1FFF);
          Buffer[finesse].push_back(word4);
          unsigned word5 =
            (digit->getSampleRise() << 24) |
            ((digit->getDeltaSamplePeak() & 0xF) << 20) |
            ((digit->getDeltaSampleFall() & 0xF) << 16);
          short checkSum = -(sumShorts(word1) + sumShorts(word2) + sumShorts(word3) +
                             sumShorts(word4) + sumShorts(word5));
          word5 |= (checkSum & 0xFFFF);
          Buffer[finesse].push_back(word5);
          Nhits++;
        }
        unsigned tail = (0x5 << 9) | (Nhits & 0x1FF);
        Buffer[finesse].push_back(tail);
      }
      RawCOPPERPackerInfo info;
      info.exp_num = evtMetaData->getExperiment();
      // run number : 14bits, subrun # : 8bits
      info.run_subrun_num = (evtMetaData->getRun() << 8) +
                            (evtMetaData->getSubrun() & 0xFF);
      info.eve_num = evtMetaData->getEvent();
      info.node_id = TOP_ID + copperID;
      info.tt_ctime = 0;
      info.tt_utime = 0;
      info.b2l_ctime = 0;
      info.hslb_crc16_error_bit = 0;
      info.truncation_mask = 0;
      info.type_of_data = 0;
 
      auto* raw = rawData.appendNew();
      raw->PackDetectorBuf(Buffer[0].data(), Buffer[0].size(),
                           Buffer[1].data(), Buffer[1].size(),
                           Buffer[2].data(), Buffer[2].size(),
                           Buffer[3].data(), Buffer[3].size(),
                           info);
    }
    delete [] sortedDigits;
  }

parseInputDirectoryLine()

int parseInputDirectoryLine

(

std::string

inputString

)

Utility function to get the directory name and the label from a line of the m_inputDirectoryList file Sets the values of m_calSetDirectory and m_calSetLabel.

Definition at line 509 of file TOPTBCComparatorModule.cc.

  {
    // resets the strings
    m_calSetDirectory.clear();
    m_calSetLabel.clear();
 
    // reads the string char by char to break it up in m_calSetDirectory and m_calSetLabel
    bool isDirectoryNameChar = true;
    bool isAtBeginning = true;
 
    for (std::string::size_type i = 0; i < inputString.size(); ++i) {
      char c = inputString[i];
      // The following ifs should catch all the possible cases
      if (c == ' ' && isAtBeginning) continue; // and empty space at the beginning of the line
      if (c == ' ' && !isAtBeginning) { // an empty space between the two parts
        isDirectoryNameChar = false;
        isAtBeginning = false;
        continue;
      }
      if (c != ' ' && isDirectoryNameChar) { // a good char belonging to the first part of the string
        m_calSetDirectory += c;
        isAtBeginning = false;
        continue;
      }
      if (c != ' ' && !isDirectoryNameChar) { // a good char belonging to the second part of the string
        m_calSetLabel += c;
        isAtBeginning = false;
        continue;
      }
      B2WARNING("Uncaught exception in parsing the input string. Ending the parsing."); // I should never reach thispoint
      return 0;
    }
 
    return 1;
  }

parseSlotAndScrodIDfromFileName()

int parseSlotAndScrodIDfromFileName

(

std::string

inputString

)

Utility function to parse the slot and BS id from the calibration file names.

Definition at line 547 of file TOPTBCComparatorModule.cc.

  {
    // resets the IDs
    m_slotID = -1;
    m_boardstackID = -1;
    m_scrodID = -1;
 
    // reads the string char by char to break it up in m_calSetDirectory and m_calSetLabel
 
 
    std::string stringSlot = "";
    std::string stringBS = "";
    std::string stringScrod  = "";
 
 
    // We may eventually implement a more clever parsere that is not so sensitive to the file name...
    //
    // tbcSlotXX_Y-scrodZZZ.root
    // tbcSlotXX_Y-scrodZZ.root
    // 012345678901234567890
    //
 
    if (!(inputString[0] == 't' && inputString[1] == 'b' &&  inputString[2] == 'c')) {
      B2WARNING(inputString << " is not a valid TBC file. Skipping it.");
      return 0;
    }
    stringSlot += inputString[7];
    stringSlot += inputString[8];
    stringBS += inputString[10];
    stringScrod += inputString[17];
    stringScrod += inputString[18];
    if (inputString[19] != '.')
      stringScrod += inputString[19];
 
 
    m_slotID = std::stoi(stringSlot);
    m_scrodID = std::stoi(stringScrod);
    m_boardstackID = std::stoi(stringBS);
 
    return 1;
  }

prepare() [1/11]

void prepare ( )

finalprivatevirtual

Replacement for initialize().

Register calibration dataobjects here as well

Reimplemented from CalibrationCollectorModule.

Definition at line 79 of file TOPAlignmentCollectorModule.cc.

  {
    // input collections
 
    m_digits.isRequired();
    m_tracks.isRequired();
    m_extHits.isRequired();
    m_recBunch.isRequired();
 
    // check if target module ID is valid
 
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    if (!geo->isModuleIDValid(m_targetMid)) {
      B2FATAL("Target module ID = " << m_targetMid << " is invalid. Exiting...");
    }
 
    // set track selector
 
    if (m_sample == "dimuon" or m_sample == "bhabha") {
      m_selector = TrackSelector(m_sample);
      m_selector.setDeltaEcms(m_deltaEcms);
      m_selector.setCutOnPOCA(m_dr, m_dz);
      m_selector.setCutOnLocalZ(m_minZ, m_maxZ);
    } else {
      B2ERROR("Invalid sample type '" << m_sample << "'");
    }
 
    // set alignment objects
 
    for (int set = 0; set < c_numSets; set++) {
      auto align = ModuleAlignment();
      align.setModuleID(m_targetMid);
      align.setSteps(m_stepPosition, m_stepAngle, m_stepTime);
      align.setParameters(m_parInit);
      for (const auto& parName : m_parFixed) {
        align.fixParameter(parName);
      }
      m_align.push_back(align);
      m_countFails.push_back(0);
    }
 
    // create and register output histograms and ntuples
 
    int numModules = geo->getNumModules();
    auto h1 = new TH2F("tracks_per_slot", "Number of tracks per slot and sample",
                       numModules, 0.5, numModules + 0.5, c_numSets, 0, c_numSets);
    h1->SetXTitle("slot number");
    h1->SetYTitle("sample number");
    registerObject<TH2F>("tracks_per_slot", h1);
 
    for (int slot = 1; slot <= numModules; slot++) {
      std::string slotName = "_s" + to_string(slot);
      std::string slotTitle = "(slot " + to_string(slot) + ")";
 
      std::string hname = "local_z" + slotName;
      std::string title = "Distribution of tracks along bar " + slotTitle;
      auto h2 = new TH1F(hname.c_str(), title.c_str(), 100, -150.0, 150.0);
      h2->SetXTitle("local z [cm]");
      registerObject<TH1F>(hname, h2);
 
      hname = "cth_vs_p" + slotName;
      title = "Track momentum " + slotTitle;
      auto h3 = new TH2F(hname.c_str(), title.c_str(), 100, 0.0, 7.0, 100, -1.0, 1.0);
      h3->SetXTitle("p [GeV/c]");
      h3->SetYTitle("cos #theta");
      registerObject<TH2F>(hname, h3);
 
      hname = "poca_xy" + slotName;
      title = "Track POCA in x-y " + slotTitle;
      auto h4 = new TH2F(hname.c_str(), title.c_str(), 100, -m_dr, m_dr, 100, -m_dr, m_dr);
      h4->SetXTitle("x [cm]");
      h4->SetYTitle("y [cm]");
      registerObject<TH2F>(hname, h4);
 
      hname = "poca_z" + slotName;
      title = "Track POCA in z " + slotTitle;
      auto h5 = new TH1F(hname.c_str(), title.c_str(), 100, -m_dz, m_dz);
      h5->SetXTitle("z [cm]");
      registerObject<TH1F>(hname, h5);
 
      hname = "Ecms" + slotName;
      title = "Track c.m.s. energy " + slotTitle;
      auto h6 = new TH1F(hname.c_str(), title.c_str(), 100, 5.1, 5.4);
      h6->SetXTitle("E_{cms} [GeV]");
      registerObject<TH1F>(hname, h6);
 
      hname = "charge" + slotName;
      title = "Charge of track " + slotTitle;
      auto h7 = new TH1F(hname.c_str(), title.c_str(), 3, -1.5, 1.5);
      h7->SetXTitle("charge");
      registerObject<TH1F>(hname, h7);
 
      hname = "timeHits" + slotName;
      title = "Photon time distribution " + slotTitle;
      auto h8 = new TH2F(hname.c_str(), title.c_str(), 512, 0, 512, 200, 0, 50);
      h8->SetXTitle("channel number");
      h8->SetYTitle("time [ns]");
      registerObject<TH2F>(hname, h8);
 
      hname = "numPhot" + slotName;
      title = "Number of photons " + slotTitle;
      auto h9 = new TH1F(hname.c_str(), title.c_str(), 100, 0, 100);
      h9->SetXTitle("photons per track");
      registerObject<TH1F>(hname, h9);
    }
 
    for (int set = 0; set < c_numSets; set++) {
      std::string name = "alignTree" + to_string(set);
      m_treeNames.push_back(name);
      auto alignTree = new TTree(name.c_str(), "TOP alignment results");
      alignTree->Branch("ModuleId", &m_targetMid);
      alignTree->Branch("iter", &m_iter);
      alignTree->Branch("ntrk", &m_ntrk);
      alignTree->Branch("errorCode", &m_errorCode);
      alignTree->Branch("iterPars", &m_vAlignPars);
      alignTree->Branch("iterParsErr", &m_vAlignParsErr);
      alignTree->Branch("valid", &m_valid);
      alignTree->Branch("numPhot", &m_numPhot);
      alignTree->Branch("x", &m_x);
      alignTree->Branch("y", &m_y);
      alignTree->Branch("z", &m_z);
      alignTree->Branch("p", &m_p);
      alignTree->Branch("theta", &m_theta);
      alignTree->Branch("phi", &m_phi);
      alignTree->Branch("r_poca", &m_pocaR);
      alignTree->Branch("z_poca", &m_pocaZ);
      alignTree->Branch("x_poca", &m_pocaX);
      alignTree->Branch("y_poca", &m_pocaY);
      alignTree->Branch("Ecms", &m_cmsE);
      alignTree->Branch("charge", &m_charge);
      alignTree->Branch("PDG", &m_PDG);
      registerObject<TTree>(name, alignTree);
    }
 
  }

prepare() [2/11]

void prepare ( )

finalprivatevirtual

Replacement for initialize().

Register calibration dataobjects here as well.

Reimplemented from CalibrationCollectorModule.

Definition at line 52 of file TOPAsicShiftsBS13dCollectorModule.cc.

  {
 
    m_topDigits.isRequired();
    if (m_requireRecBunch) {
      m_recBunch.isRequired();
    } else {
      m_recBunch.isOptional();
    }
 
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    double timeStep = geo->getNominalTDC().getSyncTimeBase() / 6;
    double xmi = - m_nx * timeStep / 2;
    double xma = m_nx * timeStep / 2;
 
    auto time_vs_BS = new TH2F("time_vs_BS", "time vs BS, slot 13",
                               16, 0.0, 512.0, m_nx, xmi, xma);
    time_vs_BS->SetXTitle("channel number");
    time_vs_BS->SetYTitle("time [ns]");
    registerObject<TH2F>("time_vs_BS", time_vs_BS);
 
    auto timeReference = new TH1F("time_reference", "time, slot 13(a, b, c)",
                                  m_nx, xmi, xma);
    timeReference->SetXTitle("time [ns]");
    timeReference->SetYTitle("entries per bin [arbitrary]");
    registerObject<TH1F>("time_reference", timeReference);
 
    for (unsigned i = 0; i < 4; i++) {
      string name = "time_carr_" + to_string(i);
      string title = "time, slot 13d, carrier " + to_string(i);
      auto h = new TH1F(name.c_str(), title.c_str(), m_nx, xmi, xma);
      h->SetXTitle("time [ns]");
      h->SetYTitle("entries per bin [arbitrary]");
      registerObject<TH1F>(name, h);
    }
 
  }

prepare() [3/11]

void prepare ( )

finalprivatevirtual

Replacement for initialize().

Register calibration dataobjects here as well

Reimplemented from CalibrationCollectorModule.

Definition at line 39 of file TOPChannelMaskCollectorModule.cc.

  {
 
    m_digits.isRequired();
 
    auto nhits = new TH1F("nhits", "Number of good hits per event; hits per event; entries per bin", 200, 0, 2000);
    registerObject<TH1F>("nhits", nhits);
 
    for (int slot = 1; slot <= 16; slot++) {
      string name = "hits_" + to_string(slot);
      string title = "Channel occupancies for slot " + to_string(slot);
      auto h = new TH1F(name.c_str(), title.c_str(), 512, 0, 512);
      h->SetXTitle("channel number");
      h->SetYTitle("number of hits per channel");
      registerObject<TH1F>(name, h);
      m_names.push_back(name);
    }
 
    for (int slot = 1; slot <= 16; slot++) {
      string name = "window_vs_asic_" + to_string(slot);
      string title = "Window vs. asic for slot " + to_string(slot);
      auto h = new TH2F(name.c_str(), title.c_str(), 64, 0, 64, 512, 0, 512);
      h->SetXTitle("ASIC number");
      h->SetYTitle("window number w.r.t reference window");
      registerObject<TH2F>(name, h);
      m_asicNames.push_back(name);
    }
 
  }

prepare() [4/11]

void prepare ( )

finalprivatevirtual

Replacement for initialize().

Register calibration dataobjects here as well

Reimplemented from CalibrationCollectorModule.

Definition at line 49 of file TOPCommonT0BFCollectorModule.cc.

  {
 
    m_recBunch.isRequired();
 
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    m_bunchTimeSep = geo->getNominalTDC().getSyncTimeBase() / m_bunchesPerSSTclk;
 
    auto h1a = new TH1F("offset_a", "current offset; offset [ns]",
                        m_nx, -m_bunchTimeSep / 2, m_bunchTimeSep / 2);
    registerObject<TH1F>("offset_a", h1a);
 
    auto h1b = new TH1F("offset_b", "current offset; offset [ns]",
                        m_nx, 0.0, m_bunchTimeSep);
    registerObject<TH1F>("offset_b", h1b);
 
  }

prepare() [5/11]

void prepare ( )

finalprivatevirtual

Replacement for initialize().

Register calibration dataobjects here as well

Reimplemented from CalibrationCollectorModule.

Definition at line 75 of file TOPCommonT0LLCollectorModule.cc.

  {
    // input collections
 
    m_digits.isRequired();
    m_tracks.isRequired();
    m_extHits.isRequired();
    m_recBunch.isRequired();
 
    // bunch time separation
 
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    m_bunchTimeSep = geo->getNominalTDC().getSyncTimeBase() / m_bunchesPerSSTclk;
 
    // Parse PDF option
 
    if (m_pdfOption == "rough") {
      m_PDFOption = PDFConstructor::c_Rough;
    } else if (m_pdfOption == "fine") {
      m_PDFOption = PDFConstructor::c_Fine;
    } else if (m_pdfOption == "optimal") {
      m_PDFOption = PDFConstructor::c_Optimal;
    } else {
      B2ERROR("Unknown PDF option '" << m_pdfOption << "'");
    }
 
    // set track selector
 
    if (m_sample == "dimuon" or m_sample == "bhabha") {
      m_selector = TrackSelector(m_sample);
      m_selector.setDeltaEcms(m_deltaEcms);
      m_selector.setCutOnPOCA(m_dr, m_dz);
      m_selector.setCutOnLocalZ(m_minZ, m_maxZ);
    } else {
      B2ERROR("Invalid sample type '" << m_sample << "'");
    }
 
    // create and register histograms
 
    double tmin = -m_timeRange / 2;
    double tmax =  m_timeRange / 2;
    for (unsigned i = 0; i < c_numSets; i++) {
      string name = "chi2_set" + to_string(i);
      auto h = new TH1D(name.c_str(), "chi2 scan; t0 [ns]; chi2",  m_numBins, tmin, tmax);
      registerObject<TH1D>(name, h);
      m_names.push_back(name);
    }
 
    auto h1 = new TH1F("tracks_per_set", "tracks per sample; sample number; num tracks",
                       c_numSets, 0, c_numSets);
    registerObject<TH1F>("tracks_per_set", h1);
 
    auto h2 = new TH1F("numHits", "Number of photons per slot",
                       c_numModules, 0.5, static_cast<float>(c_numModules) + 0.5);
    h2->SetXTitle("slot number");
    h2->SetYTitle("hits per slot");
    registerObject<TH1F>("numHits", h2);
 
    auto h3 = new TH2F("timeHits", "Photon times vs. boardstacks",
                       c_numModules * 4, 0.5, static_cast<float>(c_numModules) + 0.5, 200, 0.0, 20.0);
    h3->SetXTitle("slot number");
    h3->SetYTitle("time [ns]");
    registerObject<TH2F>("timeHits", h3);
 
    // this one is needed primarely to pass bunch time separation to the algorithm,
    // since DB interface doesn't work there
    auto h4 = new TH1F("offset", "current offset from input files; offset [ns]",
                       200, -m_bunchTimeSep / 2, m_bunchTimeSep / 2);
    registerObject<TH1F>("offset", h4);
 
  }

prepare() [6/11]

void prepare ( )

finalprivatevirtual

Replacement for initialize().

Register calibration dataobjects here as well

Reimplemented from CalibrationCollectorModule.

Definition at line 50 of file TOPModuleT0DeltaTCollectorModule.cc.

  {
 
    m_timeZeros.isRequired();
 
    auto slotPairs = new TH2F("slots", "slot pairs: number of events",
                              16, 0.5, 16.5, 16, 0.5, 16.5);
    slotPairs->SetXTitle("first slot number");
    slotPairs->SetYTitle("second slot number");
    registerObject<TH2F>("slots", slotPairs);
 
    double xmin = -m_timeRange / 2;
    double xmax = m_timeRange / 2;
    for (int slot1 = 1; slot1 <= 9; slot1++) {
      for (int slot2 = slot1 + 7; slot2 <= slot1 + 9; slot2++) {
        if (slot2 > 16) continue;
        string name = "deltaT0_" + to_string(slot1) + "-" + to_string(slot2);
        string title = "time difference: slot " + to_string(slot1) + " - slot "
                       + to_string(slot2);
        auto h = new TH1F(name.c_str(), title.c_str(), m_numBins, xmin, xmax);
        h->SetXTitle("time difference [ns]");
        registerObject<TH1F>(name, h);
      }
    }
 
  }

prepare() [7/11]

void prepare ( )

finalprivatevirtual

Replacement for initialize().

Register calibration dataobjects here as well

Reimplemented from CalibrationCollectorModule.

Definition at line 75 of file TOPModuleT0LLCollectorModule.cc.

  {
    // input collections
 
    m_digits.isRequired();
    m_tracks.isRequired();
    m_extHits.isRequired();
    m_recBunch.isRequired();
 
    // Parse PDF option
 
    if (m_pdfOption == "rough") {
      m_PDFOption = PDFConstructor::c_Rough;
    } else if (m_pdfOption == "fine") {
      m_PDFOption = PDFConstructor::c_Fine;
    } else if (m_pdfOption == "optimal") {
      m_PDFOption = PDFConstructor::c_Optimal;
    } else {
      B2ERROR("Unknown PDF option '" << m_pdfOption << "'");
    }
 
    // set track selector
 
    if (m_sample == "dimuon" or m_sample == "bhabha") {
      m_selector = TrackSelector(m_sample);
      m_selector.setDeltaEcms(m_deltaEcms);
      m_selector.setCutOnPOCA(m_dr, m_dz);
      m_selector.setCutOnLocalZ(m_minZ, m_maxZ);
    } else {
      B2ERROR("Invalid sample type '" << m_sample << "'");
    }
 
    // create and register histograms
 
    double tmin = -m_timeRange / 2;
    double tmax =  m_timeRange / 2;
    for (unsigned i = 0; i < c_numSets; i++) {
      for (int slot = 1; slot <= c_numModules; slot++) {
        double T0 = 0;
        if (m_moduleT0->isCalibrated(slot)) T0 = m_moduleT0->getT0(slot);
        string name = "chi2_set" + to_string(i) + "_slot" + to_string(slot);
        string title = "chi2 scan, slot" + to_string(slot) + "; t0 [ns]; chi2";
        auto h = new TH1D(name.c_str(), title.c_str(),  m_numBins, tmin + T0, tmax + T0);
        registerObject<TH1D>(name, h);
        m_names[i].push_back(name);
      }
    }
 
    auto h1 = new TH2F("tracks_per_slot", "tracks per slot and sample",
                       c_numModules, 0.5, static_cast<float>(c_numModules) + 0.5, c_numSets, 0, c_numSets);
    h1->SetXTitle("slot number");
    h1->SetYTitle("sample number");
    registerObject<TH2F>("tracks_per_slot", h1);
 
    auto h2 = new TH1F("numHits", "Number of photons per slot",
                       c_numModules, 0.5, static_cast<float>(c_numModules) + 0.5);
    h2->SetXTitle("slot number");
    h2->SetYTitle("hits per slot");
    registerObject<TH1F>("numHits", h2);
 
    auto h3 = new TH2F("timeHits", "Photon times vs. boardstacks",
                       c_numModules * 4, 0.5, static_cast<float>(c_numModules) + 0.5, 200, 0.0, 20.0);
    h3->SetXTitle("slot number");
    h3->SetYTitle("time [ns]");
    registerObject<TH2F>("timeHits", h3);
 
    const auto* geo = TOPGeometryPar::Instance()->getGeometry();
    double bunchTimeSep = geo->getNominalTDC().getSyncTimeBase() / 24;
    auto h4 = new TH1F("offset", "current offset from input files; offset [ns]",
                       200, -bunchTimeSep / 2, bunchTimeSep / 2);
    registerObject<TH1F>("offset", h4);
 
  }

prepare() [8/11]

void prepare ( )

finalprivatevirtual

Replacement for initialize().

Register calibration dataobjects here as well

Reimplemented from CalibrationCollectorModule.

Definition at line 41 of file TOPOffsetCollectorModule.cc.

  {
    m_recBunch.isRequired();
    m_eventT0.isRequired();
 
    m_names[Const::SVD] = "svdOffset";
    m_names[Const::CDC] = "cdcOffset";
    for (const auto& x : m_names) {
      registerObject<TH1F>(x.second, new TH1F(x.second.c_str(), "Event T0 difference w.r.t TOP; #Delta T_{0} [ns]",
                                              500, -50, 50));
    }
 
    int RFBuckets = m_bunchStructure->getRFBucketsPerRevolution();
    registerObject<TH1F>("fillPattern", new TH1F("fillPattern", "Fill pattern from DB; bucket number",
                                                 RFBuckets, 0, RFBuckets));
    registerObject<TH1F>("recBuckets", new TH1F("recBuckets", "Reconstructed buckets; bucket number",
                                                RFBuckets, 0, RFBuckets));
  }

prepare() [9/11]

void prepare ( )

finalprivatevirtual

Replacement for initialize().

Register calibration dataobjects here as well

Reimplemented from CalibrationCollectorModule.

Definition at line 58 of file TOPPhotonYieldsCollectorModule.cc.

  {
    // input collections
    m_digits.isRequired();
    m_tracks.isRequired();
    m_extHits.isRequired();
    m_recBunch.isRequired();
    m_asicMask.isRequired();
    m_associatedPDFs.isRequired();
 
    // set track selector
    if (m_sample == "dimuon" or m_sample == "bhabha") {
      m_selector = TrackSelector(m_sample);
      m_selector.setDeltaEcms(m_deltaEcms);
      m_selector.setCutOnPOCA(m_dr, m_dz);
      m_selector.setCutOnLocalZ(m_minZ, m_maxZ);
    } else {
      B2ERROR("Invalid sample type '" << m_sample << "'");
    }
 
    // create and register histograms
 
    const int numModules = 16;
    const int numPixels = 512;
 
    // time stamp (average unix time and its standard deviation)
    auto* timeStamp = new TProfile("timeStamp", "Time stamp; ; unix time", 1, 0, 1, 0, 1.0e10, "S");
    registerObject<TProfile>("timeStamp", timeStamp);
 
    // number of selected tracks per slot
    auto* numTracks = new TH1F("numTracks", "Number of tracks per slot; slot number; track count", numModules, 0.5, numModules + 0.5);
    registerObject<TH1F>("numTracks", numTracks);
 
    // number of pixel hits in a signal time window
    for (int slot = 1; slot <= numModules; slot++) {
      string name = (slot < 10) ? "signalHits_0" + to_string(slot) : "signalHits_" + to_string(slot);
      string title = "Hits in signal window for slot " + to_string(slot);
      auto h = new TH1F(name.c_str(), title.c_str(), numPixels, 0.5, numPixels + 0.5);
      h->SetXTitle("pixel number");
      h->SetYTitle("hit count");
      registerObject<TH1F>(name, h);
      m_signalNames.push_back(name);
    }
 
    // number of pixel hits in a background time window
    for (int slot = 1; slot <= numModules; slot++) {
      string name = (slot < 10) ? "bkgHits_0" + to_string(slot) : "bkgHits_" + to_string(slot);
      string title = "Hits in background window for slot " + to_string(slot);
      auto h = new TH1F(name.c_str(), title.c_str(), numPixels, 0.5, numPixels + 0.5);
      h->SetXTitle("pixel number");
      h->SetYTitle("hit count");
      registerObject<TH1F>(name, h);
      m_bkgNames.push_back(name);
    }
 
    // active pixels
    for (int slot = 1; slot <= numModules; slot++) {
      string name = (slot < 10) ? "activePixels_0" + to_string(slot) : "activePixels_" + to_string(slot);
      string title = "Active pixels for slot " + to_string(slot);
      auto h = new TH1F(name.c_str(), title.c_str(), numPixels, 0.5, numPixels + 0.5);
      h->SetXTitle("pixel number");
      h->SetYTitle("track count");
      registerObject<TH1F>(name, h);
      m_activeNames.push_back(name);
    }
 
    // number of pixel hits with low impact angle on photo cathode
    for (int slot = 1; slot <= numModules; slot++) {
      string name = (slot < 10) ? "alphaLow_0" + to_string(slot) : "alphaLow_" + to_string(slot);
      string title = "Hits w/ low alpha for slot " + to_string(slot);
      auto h = new TH1F(name.c_str(), title.c_str(), numPixels, 0.5, numPixels + 0.5);
      h->SetXTitle("pixel number");
      h->SetYTitle("hit count");
      registerObject<TH1F>(name, h);
      m_alphaLowNames.push_back(name);
    }
 
    // number of pixel hits with high impact angle on photo cathode
    for (int slot = 1; slot <= numModules; slot++) {
      string name = (slot < 10) ? "alphaHigh_0" + to_string(slot) : "alphaHigh_" + to_string(slot);
      string title = "Hits w/ high alpha for slot " + to_string(slot);
      auto h = new TH1F(name.c_str(), title.c_str(), numPixels, 0.5, numPixels + 0.5);
      h->SetXTitle("pixel number");
      h->SetYTitle("hit count");
      registerObject<TH1F>(name, h);
      m_alphaHighNames.push_back(name);
    }
 
    // pixel pulse-height distributions
    for (int slot = 1; slot <= numModules; slot++) {
      string name = (slot < 10) ? "pulseHeights_0" + to_string(slot) : "pulseHeights_" + to_string(slot);
      string title = "Pulse height distributions for slot " + to_string(slot);
      auto h = new TH2F(name.c_str(), title.c_str(), numPixels, 0.5, numPixels + 0.5, 200, 0, 2000);
      h->SetXTitle("pixel number");
      h->SetYTitle("pulse height");
      registerObject<TH2F>(name, h);
      m_pulseHeightNames.push_back(name);
    }
 
    // local z-distribution of tracks
    for (int slot = 1; slot <= numModules; slot++) {
      string name = (slot < 10) ? "muonZ_0" + to_string(slot) : "muonZ_" + to_string(slot);
      string title = "Track z-distribution for slot " + to_string(slot);
      auto h = new TH1F(name.c_str(), title.c_str(), 100, m_minZ, m_maxZ);
      h->SetXTitle("local z [cm]");
      h->SetYTitle("track count");
      registerObject<TH1F>(name, h);
      m_muonZNames.push_back(name);
    }
 
  }

prepare() [10/11]

void prepare ( )

finalprivatevirtual

Replacement for initialize().

Register calibration dataobjects here as well

Reimplemented from CalibrationCollectorModule.

Definition at line 52 of file TOPPulseHeightCollectorModule.cc.

  {
 
    m_digits.isRequired();
 
    auto h1a = new TH1F("time", "time distribution (all hits)", 1000, -100, 250);
    h1a->SetXTitle("time [ns]");
    registerObject<TH1F>("time", h1a);
 
    auto h1b = new TH1F("time_sel", "time distribution (selected hits)", 1000, -100, 250);
    h1b->SetXTitle("time [ns]");
    registerObject<TH1F>("time_sel", h1b);
 
    auto h2a = new TH2F("ph_vs_width", "pulse height vs. width (all hits)",
                        200, 0, 10, 200, 0, 2000);
    h2a->SetXTitle("pulse width [ns]");
    h2a->SetYTitle("pulse height [ADC counts]");
    registerObject<TH2F>("ph_vs_width", h2a);
 
    auto h2b = new TH2F("ph_vs_width_sel", "pulse height vs. width (selected hits)",
                        200, 0, 10, 200, 0, 2000);
    h2b->SetXTitle("pulse width [ns]");
    h2b->SetYTitle("pulse height [ADC counts]");
    registerObject<TH2F>("ph_vs_width_sel", h2b);
 
    for (int slot = 1; slot <= 16; slot++) {
      string name = "ph_slot_" + to_string(slot);
      string title = "pulse-height vs. channel for slot " + to_string(slot);
      auto h = new TH2F(name.c_str(), title.c_str(), 512, 0, 512, m_nx, 0, m_xmax);
      h->SetXTitle("channel number");
      h->SetYTitle("pulse height [ADC counts]");
      registerObject<TH2F>(name, h);
      m_names.push_back(name);
    }
 
  }

prepare() [11/11]

void prepare ( )

finalprivatevirtual

Replacement for initialize().

Register calibration dataobjects here as well

Reimplemented from CalibrationCollectorModule.

Definition at line 76 of file TOPValidationCollectorModule.cc.

  {
    // input collections
 
    m_digits.isRequired();
    m_tracks.isRequired();
    m_extHits.isRequired();
    m_recBunch.isRequired();
 
    // Parse PDF option
 
    if (m_pdfOption == "rough") {
      m_PDFOption = PDFConstructor::c_Rough;
    } else if (m_pdfOption == "fine") {
      m_PDFOption = PDFConstructor::c_Fine;
    } else if (m_pdfOption == "optimal") {
      m_PDFOption = PDFConstructor::c_Optimal;
    } else {
      B2ERROR("Unknown PDF option '" << m_pdfOption << "'");
    }
 
    // set track selector
 
    if (m_sample == "dimuon" or m_sample == "bhabha") {
      m_selector = TrackSelector(m_sample);
      m_selector.setDeltaEcms(m_deltaEcms);
      m_selector.setCutOnPOCA(m_dr, m_dz);
      m_selector.setCutOnLocalZ(m_minZ, m_maxZ);
    } else {
      B2ERROR("Invalid sample type '" << m_sample << "'");
    }
 
    // create chi2 minimum finders
 
    double tmin = -m_timeRange / 2;
    double tmax =  m_timeRange / 2;
    for (int set = 0; set < c_numSets; set++) {
      for (int slot = 1; slot <= c_numModules; slot++) {
        m_finders[set].push_back(Chi2MinimumFinder1D(m_numBins, tmin, tmax));
      }
    }
 
    // create and register histograms and tree
 
    for (int slot = 1; slot <= c_numModules; slot++) {
      string slotName = to_string(slot);
      if (slot < 10) slotName.insert(0, "0");
      string name = "chi2_slot" + slotName;
      string title = "Chi2 scan, slot" + slotName + "; channel; t0 [ns]";
      auto h = new TH2F(name.c_str(), title.c_str(),  c_numChannels, 0, c_numChannels, m_numBins, tmin, tmax);
      registerObject<TH2F>(name, h);
      m_namesChi.push_back(name);
    }
 
    for (int slot = 1; slot <= c_numModules; slot++) {
      string slotName = to_string(slot);
      if (slot < 10) slotName.insert(0, "0");
      string name = "hits_slot" + slotName;
      string title = "Photon hits, slot" + slotName + "; channel; time [ns]";
      auto h = new TH2F(name.c_str(), title.c_str(),  c_numChannels, 0, c_numChannels, 100, 0., 20.);
      registerObject<TH2F>(name, h);
      m_namesHit.push_back(name);
    }
 
    auto h = new TH1F("moduleT0_pulls", "Module T0 pulls; pulls", 200, -15.0, 15.0);
    registerObject<TH1F>("moduleT0_pulls", h);
 
    auto tree = new TTree("tree", "TOP calibration validation tree");
    tree->Branch("expNo", &m_treeEntry.expNo, "expNo/I");
    tree->Branch("runNo", &m_treeEntry.runNo, "runNo/I");
    tree->Branch("numTracks", &m_treeEntry.numTracks, "numTracks/I");
    tree->Branch("commonT0", &m_treeEntry.commonT0, "commonT0/F");
    tree->Branch("commonT0Err", &m_treeEntry.commonT0Err, "commonT0Err/F");
    tree->Branch("moduleT0", &m_treeEntry.moduleT0, "moduleT0[16]/F");
    tree->Branch("moduleT0Err", &m_treeEntry.moduleT0Err, "moduleT0Err[16]/F");
    tree->Branch("numTBCalibrated", &m_treeEntry.numTBCalibrated, "numTBCalibrated[16]/I");
    tree->Branch("numT0Calibrated", &m_treeEntry.numT0Calibrated, "numT0Calibrated[16]/I");
    tree->Branch("numActive", &m_treeEntry.numActive, "numActive[16]/I");
    tree->Branch("numActiveCalibrated", &m_treeEntry.numActiveCalibrated, "numActiveCalibrated[16]/I");
    tree->Branch("thrEffi", &m_treeEntry.thrEffi, "thrEffi[16]/F");
    tree->Branch("asicShifts", &m_treeEntry.asicShifts, "asicShifts[4]/F");
    tree->Branch("svdOffset", &m_treeEntry.svdOffset, "svdOffset/F");
    tree->Branch("svdSigma", &m_treeEntry.svdSigma, "svdSigma/F");
    tree->Branch("cdcOffset", &m_treeEntry.cdcOffset, "cdcOffset/F");
    tree->Branch("cdcSigma", &m_treeEntry.cdcSigma, "cdcSigma/F");
    tree->Branch("fillPatternOffset", &m_treeEntry.fillPatternOffset, "fillPatternOffset/F");
    tree->Branch("fillPatternFraction", &m_treeEntry.fillPatternFraction, "fillPatternFraction/F");
    registerObject<TTree>("tree", tree);
  }

printModuleParams()

void printModuleParams

(

)

const

Prints module parameters.

Definition at line 440 of file TOPBackgroundModule.cc.

  {
 
  }

printTheError()

bool printTheError ( )

private

Error messages suppression logic.

Returns

true to print the error message, false to suppress it

Definition at line 234 of file TOPUnpackerModule.cc.

  {
    if (m_eventCount < m_errorSuppressFactor * m_numErrors) return false;
    m_errorCount++;
    m_resetEventCount = true;
    return true;
  }

saveAsHistogram() [1/4]

void saveAsHistogram ( const std::vector< double > &  vec, const std::string &  name, const std::string &  title, const std::string &  xTitle = "", const std::string &  yTitle = ""  ) const

private

Save vector to histogram and write it out.

Parameters

vec	vector of bin values
name	histogram name
title	histogram title
xTitle	x-axis title
yTitle	y-axis title

Definition at line 299 of file TOPDoublePulseGeneratorModule.cc.

  {
    if (vec.empty()) return;
 
    TH1F h(name.c_str(), title.c_str(), vec.size(), 0, vec.size());
    h.SetXTitle(xTitle.c_str());
    h.SetYTitle(yTitle.c_str());
    if (name.find("Fit") != string::npos) h.SetLineColor(2);
 
    for (unsigned i = 0; i < vec.size(); i++) h.SetBinContent(i + 1, vec[i]);
 
    h.Write();
  }

saveAsHistogram() [2/4]

void saveAsHistogram ( const std::vector< double > &  vec, const std::string &  name, const std::string &  title, const std::string &  xTitle = "", const std::string &  yTitle = ""  ) const

private

Save vector to histogram and write it out.

Parameters

vec	vector of bin values
name	histogram name
title	histogram title
xTitle	x-axis title
yTitle	y-axis title

Definition at line 711 of file TOPTimeBaseCalibratorModule.cc.

  {
    if (vec.empty()) return;
 
    TH1F h(name.c_str(), title.c_str(), vec.size(), 0, vec.size());
    h.SetXTitle(xTitle.c_str());
    h.SetYTitle(yTitle.c_str());
    if (name.find("Fit") != string::npos) h.SetLineColor(2);
 
    for (unsigned i = 0; i < vec.size(); i++) h.SetBinContent(i + 1, vec[i]);
 
    h.Write();
  }

saveAsHistogram() [3/4]

void saveAsHistogram ( const std::vector< double > &  vec, const std::vector< double > &  err, const std::string &  name, const std::string &  title, const std::string &  xTitle = "", const std::string &  yTitle = ""  ) const

private

Save vector and errors to histogram and write it out.

Parameters

vec	vector of bin values
err	vector of bin errors
name	histogram name
title	histogram title
xTitle	x-axis title
yTitle	y-axis title

Definition at line 730 of file TOPTimeBaseCalibratorModule.cc.

  {
    if (vec.empty()) return;
 
    TH1F h(name.c_str(), title.c_str(), vec.size(), 0, vec.size());
    h.SetXTitle(xTitle.c_str());
    h.SetYTitle(yTitle.c_str());
 
    for (unsigned i = 0; i < vec.size(); i++) h.SetBinContent(i + 1, vec[i]);
    for (unsigned i = 0; i < err.size(); i++) h.SetBinError(i + 1, err[i]);
 
    h.Write();
  }

saveAsHistogram() [4/4]

void saveAsHistogram ( const TMatrixDSym &  M, const std::string &  name, const std::string &  title  ) const

private

Save matrix to histogram and write it out.

Parameters

M	matrix
name	histogram name
title	histogram title

Definition at line 750 of file TOPTimeBaseCalibratorModule.cc.

  {
    int n = M.GetNrows();
    TH2F h(name.c_str(), title.c_str(), n, 0, n, n, 0, n);
    h.SetXTitle("columns");
    h.SetYTitle("rows");
 
    for (int j = 0; j < n; j++) {
      for (int k = 0; k < n; k++) {
        h.SetBinContent(j + 1, n - k, M(j, k));
      }
    }
 
    h.Write();
  }

setFinder()

int setFinder ( TOP::Chi2MinimumFinder1D &  finder, const TOP::PDFConstructor &  reco, double  timeMin, double  timeMax  )

private

Sets finder object with chi2 values.

Parameters

finder	finder object
reco	reconstruction object
timeMin	lower edge of photon time window
timeMax	upper edge of photon time window

Returns

number of photons in the time window

Definition at line 623 of file TOPBunchFinderModule.cc.

  {
    std::set<int> nfotSet; // for control only
    const auto& binCenters = finder.getBinCenters();
    int numPhotons = 0;
    double logL_bkg = reco.getBackgroundLogL(timeMin, timeMax).logL;
    for (unsigned i = 0; i < binCenters.size(); i++) {
      double t0 = binCenters[i];
      auto LL = reco.getLogL(t0, timeMin, timeMax, m_sigmaSmear);
      finder.add(i, -2 * (LL.logL - logL_bkg));
      if (i == 0) numPhotons = LL.numPhotons;
      nfotSet.insert(LL.numPhotons);
    }
 
    if (nfotSet.size() != 1) B2ERROR("Different number of photons used for log likelihood of different time shifts");
 
    return numPhotons;
  }

startRun()

void startRun ( )

finalprivatevirtual

Replacement for beginRun().

Do anything you would normally do in beginRun here

Reimplemented from CalibrationCollectorModule.

Definition at line 167 of file TOPValidationCollectorModule.cc.

  {
    // initialize tree variables
 
    m_treeEntry.clear();
    StoreObjPtr<EventMetaData> evtMetaData;
    m_treeEntry.expNo = evtMetaData->getExperiment();
    m_treeEntry.runNo = evtMetaData->getRun();
 
    // clear minimum finders
 
    for (auto& finders : m_finders) {
      for (auto& finder : finders) finder.clear();
    }
 
    // pass payload summaries to tree
 
    const auto& fe_mapper = TOPGeometryPar::Instance()->getFrontEndMapper();
    for (unsigned module = 0; module < c_numModules; module++) {
      auto& numTBCalibrated = m_treeEntry.numTBCalibrated[module];
      auto& numT0Calibrated = m_treeEntry.numT0Calibrated[module];
      auto& numActive = m_treeEntry.numActive[module];
      auto& numActiveCalibrated = m_treeEntry.numActiveCalibrated[module];
      auto& thrEffi = m_treeEntry.thrEffi[module];
      int slot = module + 1;
      for (unsigned channel = 0; channel < c_numChannels; channel++) {
        bool tbCalibrated = false;
        const auto* fe = fe_mapper.getMap(slot, channel / 128);
        if (fe) {
          tbCalibrated = m_timebase->isAvailable(fe->getScrodID(), channel);
        } else {
          B2ERROR("No front-end map found");
        }
        bool t0Calibrated = m_channelT0->isCalibrated(slot, channel);
        bool active = m_channelMask->isActive(slot, channel);
        if (tbCalibrated) numTBCalibrated++;
        if (t0Calibrated) numT0Calibrated++;
        if (active) numActive++;
        if (tbCalibrated and t0Calibrated and active) {
          numActiveCalibrated++;
          thrEffi += m_thresholdEff->getThrEff(slot, channel);
        }
      }
      if (numActiveCalibrated > 0) thrEffi /= numActiveCalibrated;
    }
 
    for (unsigned carrier = 0; carrier < 4; carrier++) {
      unsigned asic = (3 * 4 + carrier) * 4;
      m_treeEntry.asicShifts[carrier] = m_asicShift->isCalibrated(13, asic) ? m_asicShift->getT0(13, asic) :
                                        std::numeric_limits<float>::quiet_NaN();
    }
 
    const auto& svd = m_eventT0Offset->get(Const::SVD);
    m_treeEntry.svdOffset = svd.offset;
    m_treeEntry.svdSigma = svd.sigma;
 
    const auto& cdc = m_eventT0Offset->get(Const::CDC);
    m_treeEntry.cdcOffset = cdc.offset;
    m_treeEntry.cdcSigma = cdc.sigma;
 
    m_treeEntry.fillPatternOffset = m_fillPatternOffset->isCalibrated() ? m_fillPatternOffset->get() :
                                    std::numeric_limits<float>::quiet_NaN();
    m_treeEntry.fillPatternFraction = m_fillPatternOffset->getFraction();
  }

storeSampleTimes()

void storeSampleTimes ( std::string  fileName )

private

Optionally store sample times used by the generator as root histograms fileName root output file name.

Definition at line 228 of file TOPDoublePulseGeneratorModule.cc.

  {
    if (fileName.empty()) return;
 
    TFile* fout = TFile::Open(fileName.c_str(), "recreate");
    if (!fout) {
      B2ERROR("Can't open the output file " << fileName);
      return;
    }
 
    const auto& feMapper = TOPGeometryPar::Instance()->getFrontEndMapper();
 
    TH1F scrods("scrodID", "scrod ID's mapped to slots/boardstacks", 64, -0.5, 63.5);
    scrods.SetXTitle("(slot - 1) * 4 + boardstack");
    scrods.SetYTitle("scrod ID");
 
    for (auto moduleID : m_moduleIDs) {
      for (int bs = 0; bs < 4; bs++) {
        const auto* feMap = feMapper.getMap(moduleID, bs);
        if (!feMap) {
          B2ERROR("No front-end mapping available for slot " << moduleID
                  << " boardstack " << bs);
          continue;
        }
        unsigned scrodID = feMap->getScrodID();
        std::string subdir = "scrod" + std::to_string(scrodID);
        int i = (moduleID - 1) * 4 + bs;
        scrods.SetBinContent(i + 1, scrodID);
        fout->mkdir(subdir.c_str());
      }
    }
    scrods.Write();
 
    for (auto moduleID : m_moduleIDs) {
      for (unsigned asic = 0; asic < 64; asic++) {
        int bs = asic / 16;
        const auto* feMap = feMapper.getMap(moduleID, bs);
        if (!feMap) continue;
        unsigned scrodID = feMap->getScrodID();
        std::string subdir = "scrod" + std::to_string(scrodID);
        fout->cd(subdir.c_str());
        for (auto asicChannel : m_asicChannels) {
          unsigned channel = (asic * 8 + asicChannel) % 128;
          const TOPSampleTimes* sampleTimes = &m_sampleTimes;
          if (m_useDatabase) {
            sampleTimes = (*m_timebase)->getSampleTimes(scrodID, channel);
          }
          string forWhat = "scrod " + to_string(scrodID) +
                           " channel " + to_string(channel) +
                           " (slot" + to_string(moduleID) + ", as" + to_string(asic) +
                           ", ch" + to_string(asicChannel) + ")";
          auto timeAxis = sampleTimes->getTimeAxis();
          saveAsHistogram(timeAxis, "sampleTimes_ch" + to_string(channel),
                          "Generator input: sample times for " + forWhat,
                          "sample number", "t [ns]");
          std::vector<double> dt;
          for (unsigned i = 1; i < timeAxis.size(); i++) {
            dt.push_back(timeAxis[i] - timeAxis[i - 1]);
          }
          saveAsHistogram(dt, "dt_ch" + to_string(channel),
                          "Generator input: sample time bins for " + forWhat,
                          "sample number", "#Delta t [ns]");
        }
      }
    }
 
    fout->Close();
 
  }

terminate() [1/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 252 of file TOPAlignerModule.cc.

  {
 
    m_file->cd();
    m_alignTree->Write();
 
    TH1F valid("valid", "status valid", 16, 0.5, 16.5);
    valid.SetXTitle("slot ID");
    valid.SetBinContent(m_targetMid, m_valid);
    valid.Write();
 
    TH1F ntrk("ntrk", "number of tracks", 16, 0.5, 16.5);
    ntrk.SetXTitle("slot ID");
    ntrk.SetBinContent(m_targetMid, m_ntrk);
    ntrk.Write();
 
    std::string name, title;
    name = "results_slot" + to_string(m_targetMid);
    title = "alignment parameters, slot " + to_string(m_targetMid);
    int npar = m_align.getParams().size();
    TH1F h0(name.c_str(), title.c_str(), npar, 0, npar);
    const auto& par = m_align.getParams();
    const auto& err = m_align.getErrors();
    for (int i = 0; i < npar; i++) {
      h0.SetBinContent(i + 1, par[i]);
      h0.SetBinError(i + 1, err[i]);
    }
    h0.Write();
 
    name = "errMatrix_slot" + to_string(m_targetMid);
    title = "error matrix, slot " + to_string(m_targetMid);
    TH2F h1(name.c_str(), title.c_str(), npar, 0, npar, npar, 0, npar);
    const auto& errMatrix = m_align.getErrorMatrix();
    for (int i = 0; i < npar; i++) {
      for (int k = 0; k < npar; k++) {
        h1.SetBinContent(i + 1, k + 1, errMatrix[i][k]);
      }
    }
    h1.Write();
 
    name = "corMatrix_slot" + to_string(m_targetMid);
    title = "correlation matrix, slot " + to_string(m_targetMid);
    TH2F h2(name.c_str(), title.c_str(), npar, 0, npar, npar, 0, npar);
    std::vector<double> diag;
    for (int i = 0; i < npar; i++) {
      double d = errMatrix[i][i];
      if (d != 0) d = 1.0 / sqrt(d);
      diag.push_back(d);
    }
    for (int i = 0; i < npar; i++) {
      for (int k = 0; k < npar; k++) {
        h2.SetBinContent(i + 1, k + 1, diag[i] * diag[k] * errMatrix[i][k]);
      }
    }
    h2.Write();
 
    m_file->Close();
 
    if (m_valid) {
      B2RESULT("TOPAligner: slot = " << m_targetMid << ", status = successful, "
               << "iterations = " << m_iter << ", tracks used = " << m_ntrk);
    } else {
      B2RESULT("TOPAligner: slot = " << m_targetMid << ", status = failed, "
               << "error code = " << m_errorCode
               << ", iterations = " << m_iter << ", tracks used = " << m_ntrk);
    }
  }

terminate() [2/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 405 of file TOPBackgroundModule.cc.

  {
    /*
     myprint(peflux, ("peflux_" + m_BkgType + ".pdf").c_str(), "#phi", "MHz / PMT", 1.);
     myprint(zdist, ("zdist_" + m_BkgType + ".pdf").c_str(), "z[cm]", "", 0.0);
     myprint(nflux, ("nflux_" + m_BkgType + ".pdf").c_str(), "#phi", "neutrons / cm^{2} / year", 0.0);
     myprint(rdose, ("rdose_" + m_BkgType + ".pdf").c_str(), "#phi", "Gy/year", 0.0);
     */
 
    m_rootFile->cd();
    origingamma->Write();
    originpe->Write();
    peflux->Write();
    zdist->Write();
    nflux->Write();
    rdose->Write();
    genergy->Write();
    genergy2->Write();
    nflux_bar->Write();
    gflux_bar->Write();
    origin_zx->Write();
    origin_zy->Write();
    module_occupancy->Write();
    gorigin->Write();
    norigin->Write();
    zdistg->Write();
    originpt->Write();
    m_rootFile->Close();
 
    // Announce
    B2INFO("TOPBackground finished");
 
 
  }

terminate() [3/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 557 of file TOPBunchFinderModule.cc.

  {
    B2RESULT("TOPBunchFinder: event T0 determined for " << m_success << "/"
             << m_processed << " events");
  }

terminate() [4/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 259 of file TOPChannelT0CalibratorModule.cc.

  {
 
    // determine scaling factor for errors from two statistically independent results
 
    TH1F h_pulls("pulls", "Pulls of the two statistically independent results",
                 200, -15.0, 15.0);
    h_pulls.SetXTitle("pulls");
    for (unsigned module = 0; module < c_numModules; module++) {
      for (unsigned channel = 0; channel < c_numChannels; channel++) {
        std::vector<double> pos, err;
        for (int i = 0; i < 2; i++) {
          const auto& minimum = m_finders[i][module][channel].getMinimum();
          if (not minimum.valid) continue;
          pos.push_back(minimum.position);
          err.push_back(minimum.error);
        }
        if (pos.size() < 2) continue;
        double pull = (pos[0] - pos[1]) / sqrt(err[0] * err[0] + err[1] * err[1]);
        h_pulls.Fill(pull);
      }
    }
    h_pulls.Write();
    double scaleError = h_pulls.GetRMS();
 
    // merge two statistically independent finders and store results into histograms
 
    for (unsigned module = 0; module < c_numModules; module++) {
      int moduleID = module + 1;
 
      std::string slotNum = std::to_string(moduleID);
      if (moduleID < 10) slotNum = "0" + slotNum;
 
      std::string name = "channelT0_slot" + slotNum;
      std::string title = "Relative channel T0 for slot " + slotNum;
      TH1F h_channelT0(name.c_str(), title.c_str(), c_numChannels, 0, c_numChannels);
      h_channelT0.SetXTitle("channel number");
      h_channelT0.SetYTitle("relative channel T0 [ns]");
 
      for (unsigned channel = 0; channel < c_numChannels; channel++) {
        auto& finder = m_finders[0][module][channel].add(m_finders[1][module][channel]);
        const auto& minimum = finder.getMinimum();
        if (minimum.valid) {
          h_channelT0.SetBinContent(channel + 1, minimum.position);
          h_channelT0.SetBinError(channel + 1, minimum.error * scaleError);
        }
      }
 
      h_channelT0.Write();
 
    }
 
    // merge all finders of a slot to find module T0
 
    TH1F h_moduleT0("moduleT0", "Relative module T0",
                    c_numModules, 0.5, static_cast<float>(c_numModules) + 0.5);
    h_moduleT0.SetXTitle("slot number");
    h_moduleT0.SetYTitle("relative module T0 [ns]");
    auto finderCommon = m_finders[0][0][0];
    finderCommon.clear();
    for (unsigned module = 0; module < c_numModules; module++) {
      auto finder = m_finders[0][module][0];
      finder.clear();
      for (unsigned channel = 0; channel < c_numChannels; channel++) {
        finder.add(m_finders[0][module][channel]);
      }
      finderCommon.add(finder);
      const auto& minimum = finder.getMinimum();
      if (minimum.valid) {
        h_moduleT0.SetBinContent(module + 1, minimum.position);
        h_moduleT0.SetBinError(module + 1, minimum.error * scaleError);
      }
    }
    h_moduleT0.Write();
 
    // find common T0
 
    TH1F h_commonT0("commonT0", "Relative common T0", 1, 0, 1);
    h_commonT0.SetYTitle("relative common T0 [ns]");
    const auto& minimum = finderCommon.getMinimum();
    if (minimum.valid) {
      h_commonT0.SetBinContent(1, minimum.position);
      h_commonT0.SetBinError(1, minimum.error * scaleError);
    }
    h_commonT0.Write();
 
    // write other histograms and ntuple; close the file
 
    for (auto& h : m_hits1D) h.Write();
    for (auto& h : m_hits2D) h.Write();
 
    m_tree->Write();
    m_file->Close();
 
    B2RESULT("Results available in " << m_outFileName);
  }

terminate() [5/23]

void terminate ( void  )

overridevirtual

Termination action.

Output MC extraction

Reimplemented from Module.

Definition at line 93 of file TOPChannelT0MCModule.cc.

  {
    auto file = new TFile(m_outputFile.c_str(), "RECREATE");
    auto otree = new TTree("t0MC", "extract channel t0 info. from MC");
 
    unsigned channel = 0;
    double maxpos = 0;
 
    otree->Branch("maxpos", &maxpos, "maxpos/D");
    otree->Branch("channel", &channel, "channel/I");
 
    for (int i = 0; i < c_NumChannels; i++) {
      channel = i;
      maxpos = m_histo[i]->GetXaxis()->GetBinCenter(m_histo[i]->GetMaximumBin());
      otree->Fill();
    }
    otree->Write();
    delete otree;
    file->Close();
    delete file;
  }

terminate() [6/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 243 of file TOPCommonT0CalibratorModule.cc.

  {
 
    // determine scaling factor for errors from statistically independent results
 
    TH1F h_pulls("pulls", "Pulls of statistically independent results",
                 200, -15.0, 15.0);
    h_pulls.SetXTitle("pulls");
    std::vector<double> pos, err;
    for (int i = 0; i < c_numSets; i++) {
      const auto& minimum = m_finders[i].getMinimum();
      if (not minimum.valid) continue;
      pos.push_back(minimum.position);
      err.push_back(minimum.error);
    }
    for (unsigned i = 0; i < pos.size(); i++) {
      for (unsigned j = i + 1; j < pos.size(); j++) {
        double pull = (pos[i] - pos[j]) / sqrt(err[i] * err[i] + err[j] * err[j]);
        h_pulls.Fill(pull);
      }
    }
    h_pulls.Write();
    double scaleError = 1;
    if (h_pulls.GetEntries() > 1) scaleError = h_pulls.GetRMS();
 
    // merge statistically independent finders and store results into histograms
 
    auto finder = m_finders[0];
    for (int i = 1; i < c_numSets; i++) {
      finder.add(m_finders[i]);
    }
 
    TH1F h_relCommonT0("relCommonT0", "relative common T0", 1, 0, 1);
    h_relCommonT0.SetYTitle("common T0 residual [ns]");
    TH1F h_commonT0("commonT0", "Common T0", 1, 0, 1);
    h_commonT0.SetYTitle("common T0 [ns]");
 
    const auto& minimum = finder.getMinimum();
    auto h = finder.getHistogram("chi2", "chi2");
    h.Write();
    if (minimum.valid) {
      h_relCommonT0.SetBinContent(1, minimum.position);
      h_relCommonT0.SetBinError(1, minimum.error * scaleError);
      double T0 = minimum.position;
      if (m_commonT0->isCalibrated()) T0 += m_commonT0->getT0();
      T0 -= round(T0 / m_bunchTimeSep) * m_bunchTimeSep; // wrap around
      h_commonT0.SetBinContent(1, T0);
      h_commonT0.SetBinError(1, minimum.error * scaleError);
    }
    h_relCommonT0.Write();
    h_commonT0.Write();
 
    // write other histograms and ntuple; close the file
 
    m_hits1D.Write();
    m_hits2D.Write();
    m_tree->Write();
    m_file->Close();
 
    B2RESULT("Results available in " << m_outFileName);
  }

terminate() [7/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 249 of file TOPCosmicT0FinderModule.cc.

  {
    B2RESULT("TOPCosmicT0Finder: accepted events " << m_acceptedCount
             << ", event T0 determined for " << m_successCount << " events");
  }

terminate() [8/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 154 of file TOPTriggerDigitizerModule.cc.

  {
 
  }

terminate() [9/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 223 of file TOPDoublePulseGeneratorModule.cc.

  {
  }

terminate() [10/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from HistoModule.

Definition at line 173 of file TOPGainEfficiencyCalculatorModule.cc.

  {
    //first, check validity of input parameters
    bool areGoodParameters = true;
    if (m_targetSlotId < 1 || m_targetSlotId > c_NModule) {
      B2ERROR("TOPGainEfficiencyCalculator : invalid slotID : " << m_targetSlotId);
      areGoodParameters = false;
    }
    if (m_targetPmtId < 1 || m_targetPmtId > c_NPMTPerModule) {
      B2ERROR("TOPGainEfficiencyCalculator : invalid PMT ID : " << m_targetPmtId);
      areGoodParameters = false;
    }
    if (m_pedestalSigma < 1e-6) {
      B2ERROR("TOPGainEfficiencyCalculator : pedestal sigma must be non-zero positive value");
      areGoodParameters = false;
    }
 
    //do not proceed to the main process unless all the input parameters are not valid
    if (areGoodParameters) {
      if (m_outputPDFFile.size() == 0) {
        if (m_inputFile.rfind(".") == std::string::npos)
          m_outputPDFFile = m_inputFile;
        else
          m_outputPDFFile = m_inputFile.substr(0, m_inputFile.rfind("."));
      }
 
      //gain run using height distribution
      LoadHistograms("Height_gain");
      FitHistograms(c_LoadForFitHeight);
      DrawResult("Height_gain", c_LoadForFitHeight);
 
      //efficiency run
      LoadHistograms("Height_efficiency");
      FitHistograms(c_LoadHitRateHeight);
      DrawResult("Height_efficiency", c_LoadHitRateHeight);
 
      //gain run using integral distribution
      LoadHistograms("Integral_gain");
      FitHistograms(c_LoadForFitIntegral);
      DrawResult("Integral_gain", c_LoadForFitIntegral);
 
    }
  }

terminate() [11/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from HistoModule.

Definition at line 260 of file TOPLaserHitSelectorModule.cc.

  {
  }

terminate() [12/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from HistoModule.

Definition at line 335 of file TOPInterimFENtupleModule.cc.

  {
  }

terminate() [13/23]

void terminate ( void  )

overridevirtual

Termination action.

Do fits , clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 113 of file TOPLaserCalibratorModule.cc.

  {
    std::vector<TH1F*> v_histo;
    for (int i = 0; i < c_NumChannels; ++i) {
      v_histo.push_back(m_histo[i]);
    }
 
    double dataT[c_NumChannels] = {0};
    double dataTErr[c_NumChannels] = {0};
    double mcT[c_NumChannels] = {0};
 
    TOP::LaserCalibratorFit t0fit(m_barID);
    t0fit.setHist(v_histo); //set time hist vector
    t0fit.setFitMethod(m_fitMethod);
    t0fit.setFitRange(m_fitRange[1], m_fitRange[2]);
    if (m_fitChannel == c_NumChannels) {
      for (int i = 0; i < c_NumChannels; ++i) {
        t0fit.fitChannel(i);
        dataT[i] = t0fit.getFitT();
        dataTErr[i] = t0fit.getFitTErr();
      }
    } else {
      t0fit.fitChannel(m_fitChannel);
      dataT[m_fitChannel] = t0fit.getFitT();
    }
    //cout<<"chisq=\t"<<t0fit.getFitChisq(6)<<endl;
    t0fit.writeFile(m_dataFitOutput); //write to root file
 
    //read laser propagation time from MC (TOPChannelT0MC)
    auto mcFile = new TFile(m_mcInput.c_str());
    auto tree = static_cast<TTree*>(mcFile->Get("t0MC"));
    int channel_mc;
    double maxpos;
 
    tree->SetBranchAddress("channel", &channel_mc);
    tree->SetBranchAddress("maxpos", &maxpos);
    for (int i = 0; i < tree->GetEntries(); i++) {
      tree->GetEntry(i);
      mcT[channel_mc] = maxpos;
    }
 
    //w.r.t. ref. channel
    for (int i = 0; i < c_NumChannels; i++) {
      if (i == m_refCh) continue;
      dataT[i] = dataT[i] - dataT[m_refCh];
      mcT[i] = mcT[i] - mcT[m_refCh];
    }
 
    delete tree;
    mcFile->Close();
    delete mcFile;
 
    //calculate T0 Const, write to root file
    auto file = new TFile(m_chT0C.c_str(), "RECREATE");
    auto otree = new TTree("chT0", "Channel T0 Const");
 
    unsigned channel = 0;
    double t0_const = 0;
    double t0ConstRaw = 0;
    double fittedTime = 0;
    double fittedTimeError = 0;
    double mcTime = 0;
    double mcCorrection = 0;
    double t0ConstError = 0;
 
    otree->Branch("fittedTime", &fittedTime, "fittedTime/D");
    otree->Branch("fittedTimeError", &fittedTimeError, "fittedTimeError/D");
    otree->Branch("mcTime", &mcTime, "mcTime/D");
    otree->Branch("t0ConstRaw", &t0ConstRaw, "t0ConstRaw/D");
    otree->Branch("mcCorrection", &mcCorrection, "mcCorrection/D");
    otree->Branch("t0Const", &t0_const, "t0_const/D");
    otree->Branch("t0ConstError", &t0ConstError, "t0ConstError/D");
    otree->Branch("channel", &channel, "channel/I");
    otree->Branch("slot", &m_barID, "slot/I");
 
    for (int i = 0; i < c_NumChannels; i++) {
      if (i == m_refCh) {
        fittedTime = dataT[i];
        mcTime = mcT[i];
      } else {
        fittedTime = dataT[i] + dataT[m_refCh];
        mcTime = mcT[i] +  mcT[m_refCh];
      }
      fittedTimeError = dataTErr[i];
      t0ConstRaw = dataT[i];
      mcCorrection = mcT[i];
      channel = i;
      t0_const = dataT[i] - mcT[i];
      // assuming that the MC error is negligible
      t0ConstError = TMath::Sqrt(dataTErr[i] * dataTErr[i] + dataTErr[m_refCh] * dataTErr[m_refCh]);
      if (i == m_refCh) {
        t0_const = 0;
        t0ConstError = dataTErr[m_refCh];
      }
      otree->Fill();
    }
    otree->Write();
    delete otree;
    file->Close();
    delete file;
 
    // ...
    // write to database; next to do ...
    // ...
  }

terminate() [14/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 146 of file TOPMCTrackMakerModule.cc.

  {
  }

terminate() [15/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 252 of file TOPModuleT0CalibratorModule.cc.

  {
    // determine scaling factor for errors from two statistically independent results
 
    TH1F h_pulls("pulls", "Pulls of the two statistically independent results",
                 200, -15.0, 15.0);
    h_pulls.SetXTitle("pulls");
    for (unsigned module = 0; module < c_numModules; module++) {
      std::vector<double> pos, err;
      for (int i = 0; i < 2; i++) {
        const auto& minimum = m_finders[i][module].getMinimum();
        if (not minimum.valid) continue;
        pos.push_back(minimum.position);
        err.push_back(minimum.error);
      }
      if (pos.size() < 2) continue;
      double pull = (pos[0] - pos[1]) / sqrt(err[0] * err[0] + err[1] * err[1]);
      h_pulls.Fill(pull);
    }
    h_pulls.Write();
    double scaleError = h_pulls.GetRMS();
 
    // merge two statistically independent finders and store results into histograms
 
    TH1F h_relModuleT0("relModuleT0", "Module T0 relative to calibration",
                       c_numModules, 0.5, static_cast<float>(c_numModules) + 0.5);
    h_relModuleT0.SetXTitle("slot number");
    h_relModuleT0.SetYTitle("module T0 residual [ns]");
 
    for (unsigned module = 0; module < c_numModules; module++) {
      auto& finder = m_finders[0][module].add(m_finders[1][module]);
      const auto& minimum = finder.getMinimum();
      if (minimum.valid) {
        h_relModuleT0.SetBinContent(module + 1, minimum.position);
        h_relModuleT0.SetBinError(module + 1, minimum.error * scaleError);
      }
      std::string slotNum = to_string(module + 1);
      auto h = finder.getHistogram("chi2_slot_" + slotNum, "slot " + slotNum);
      h.Write();
    }
    h_relModuleT0.Write();
 
    // absolute module T0
    TH1F h_moduleT0("moduleT0", "Module T0",
                    c_numModules, 0.5, static_cast<float>(c_numModules) + 0.5);
    h_moduleT0.SetXTitle("slot number");
    h_moduleT0.SetYTitle("module T0 [ns]");
 
    double average = 0; // average to be subtracted
    int num = 0;
    for (int slot = 1; slot <= c_numModules; slot++) {
      if (h_relModuleT0.GetBinError(slot) > 0) {
        double T0 = 0;
        if (m_moduleT0->isCalibrated(slot)) T0 = m_moduleT0->getT0(slot);
        average += h_relModuleT0.GetBinContent(slot) + T0;
        num++;
      }
    }
    if (num > 0) average /= num;
 
    for (int slot = 1; slot <= c_numModules; slot++) {
      double T0 = 0;
      if (m_moduleT0->isCalibrated(slot)) T0 = m_moduleT0->getT0(slot);
      double t0 = h_relModuleT0.GetBinContent(slot) + T0 - average;
      double err = h_relModuleT0.GetBinError(slot);
      h_moduleT0.SetBinContent(slot, t0);
      h_moduleT0.SetBinError(slot, err);
    }
    h_moduleT0.Write();
 
    // write other histograms and ntuple; close the file
 
    m_hits1D.Write();
    m_hits2D.Write();
    m_tree->Write();
    m_file->Close();
 
    B2RESULT(num << "/16 calibrated. Results available in " << m_outFileName);
  }

terminate() [16/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 274 of file TOPNtupleModule.cc.

  {
    TDirectory::TContext context;
    m_file->cd();
    m_tree->Write();
    m_file->Close();
  }

terminate() [17/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 127 of file TOPPackerModule.cc.

  {
  }

terminate() [18/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from HistoModule.

Definition at line 182 of file TOPPDFCheckerModule.cc.

  {
    m_avrgPosition *= 1.0 / m_numTracks;
    m_avrgMomentum *= 1.0 / m_numTracks;
 
    cout << "Average particle parameters at entrance to bar (in local frame):" << endl;
    cout << " slot ID: ";
    for (auto slot : m_slotIDs) cout << slot << " ";
    cout << endl;
    cout << " PDG code: ";
    for (auto pdg : m_PDGCodes) cout << pdg << " ";
    cout << endl;
    cout << " position: x = " << m_avrgPosition.X()
         << ", y = " << m_avrgPosition.Y()
         << ", z = " << m_avrgPosition.Z() << endl;
    cout << " momentum: p = " << m_avrgMomentum.R()
         << ", theta = " << m_avrgMomentum.Theta() / Unit::deg
         << ", phi = " << m_avrgMomentum.Phi() / Unit::deg << endl;
    cout << "Number of particles: " << m_numTracks << endl;
    cout << "Photons per particle: simulation = " << m_hits->GetSum() / m_numTracks
         << ", PDF = " << m_pdf->GetSum() / m_numTracks << endl;
 
  }

terminate() [19/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 481 of file TOPRawDigitConverterModule.cc.

  {
  }

terminate() [20/23]

void terminate ( void  )

overridevirtual

Termination action.

The historam writing takes place here

Reimplemented from HistoModule.

Definition at line 453 of file TOPTBCComparatorModule.cc.

  {
    // writes the histos
    B2INFO("Creating output file " << m_outputFile);
    TFile outfile(m_outputFile.c_str(), "recreate");
 
    B2INFO("Writing histograms ");
 
    // opens the input list to retrive, one last time, the labels
    ifstream inputDirectoryListFile(m_inputDirectoryList.c_str());
    std::string inputString;
    int iSet = 0;
 
    while (std::getline(inputDirectoryListFile, inputString)) {
      parseInputDirectoryLine(inputString);
      TDirectory* dirSet = outfile.mkdir(m_calSetLabel.c_str());
      dirSet->cd();
 
      m_topAverageDeltaT[iSet]->Write();
      m_topSigmaDeltaT[iSet]->Write();
      m_topSampleOccupancy[iSet]->Write();
      m_topAverageDeltaTComparison[iSet]->Write();
      m_topSigmaDeltaTComparison[iSet]->Write();
      m_topSampleOccupancyComparison[iSet]->Write();
 
      for (int iSlot = 0; iSlot < 16; iSlot ++) {
        TDirectory* dirSlot = dirSet->mkdir(str(format("slot%1%") % (iSlot + 1)).c_str());
        dirSlot->cd();
 
        m_slotAverageDeltaT[iSlot][iSet]->Write();
        m_slotSigmaDeltaT[iSlot][iSet]->Write();
        m_slotAverageDeltaTMap[iSlot][iSet]->Write();
        m_slotSigmaDeltaTMap[iSlot][iSet]->Write();
        m_slotSampleOccupancy[iSlot][iSet]->Write();
        m_slotEmptySamples[iSlot][iSet]->Write();
        m_slotSampleOccupancyMap[iSlot][iSet]->Write();
        m_slotEmptySamplesMap[iSlot][iSet]->Write();
 
        m_slotAverageDeltaTComparison[iSlot][iSet]->Write();
        m_slotSigmaDeltaTComparison[iSlot][iSet]->Write();
        m_slotAverageDeltaTMapComparison[iSlot][iSet]->Write();
        m_slotSigmaDeltaTMapComparison[iSlot][iSet]->Write();
      }
      dirSet->cd();
      iSet++;
    }
  }

terminate() [21/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 220 of file TOPTimeBaseCalibratorModule.cc.

  {
 
    const auto& feMapper = TOPGeometryPar::Instance()->getFrontEndMapper();
 
    for (unsigned bs = 0; bs < c_NumBoardstacks; bs ++) {
 
      // determine scrod ID
 
      const auto* feMap = feMapper.getMap(m_moduleID, bs);
      if (!feMap) {
        B2ERROR("No front-end map available for slot " << m_moduleID << ", BS" << bs);
        continue;
      }
      unsigned scrodID = feMap->getScrodID();
 
      // open output root file
 
      string fileName = m_directoryName + "/tbcSlot";
      if (m_moduleID < 10) {
        fileName += "0" + to_string(m_moduleID);
      } else {
        fileName += to_string(m_moduleID);
      }
      fileName += "_" + to_string(bs) + "-scrod" +
                  to_string(scrodID) + ".root";
      TFile* fout = TFile::Open(fileName.c_str(), "recreate");
      if (!fout) {
        B2ERROR("Can't open the output file " << fileName);
        continue;
      }
 
      // write control histograms
 
      m_goodHits.Write();
      m_calPulseFirst.Write();
      m_calPulseSecond.Write();
 
      B2INFO("Fitting time base corrections for SCROD " << scrodID
             << ", output file: " << fileName);
 
      // book histograms
 
      TH1F Hchan("channels", "channels with cal pulse",
                 c_NumScrodChannels, 0, c_NumScrodChannels);
      Hchan.SetXTitle("channel number");
      Hchan.SetYTitle("double cal pulse counts");
      TH1F Hsuccess("success", "successfuly fitted channels",
                    c_NumScrodChannels, 0, c_NumScrodChannels);
      Hsuccess.SetXTitle("channel number");
      TH1F Hchi2("chi2", "normalized chi2",
                 c_NumScrodChannels, 0, c_NumScrodChannels);
      Hchi2.SetXTitle("channel number");
      Hchi2.SetYTitle("chi2/ndf");
      TH1F Hndf("ndf", "degrees of freedom",
                c_NumScrodChannels, 0, c_NumScrodChannels);
      Hndf.SetXTitle("channel number");
      Hndf.SetYTitle("ndf");
      TH1F HDeltaT("DeltaT", "Fitted double pulse delay time",
                   c_NumScrodChannels, 0, c_NumScrodChannels);
      HDeltaT.SetXTitle("channel number");
      HDeltaT.SetYTitle("#Delta T [ns]");
 
      // loop over channels of a single SCROD
 
      for (unsigned chan = 0; chan < c_NumScrodChannels; chan++) {
        unsigned channel = chan + bs * c_NumScrodChannels;
        auto& ntuple = m_ntuples[channel];
        Hchan.SetBinContent(chan + 1, ntuple.size());
        if (ntuple.size() > m_minHits) {
          bool ok = calibrateChannel(ntuple, scrodID, chan, Hchi2, Hndf, HDeltaT);
          if (ok) Hsuccess.Fill(chan);
        } else {
          B2INFO("... channel " << chan << " statistics too low ("
                 << ntuple.size() << " double cal pulses)");
        }
      }
 
      // write histograms and close the file
 
      Hchan.Write();
      Hsuccess.Write();
      Hchi2.Write();
      Hndf.Write();
      HDeltaT.Write();
      fout->Close();
 
    }
  }

terminate() [22/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 1254 of file TOPUnpackerModule.cc.

  {
  }

terminate() [23/23]

void terminate ( void  )

overridevirtual

Termination action.

Clean-up, close files, summarize statistics, etc.

Reimplemented from Module.

Definition at line 144 of file TOPWaveformFeatureExtractorModule.cc.

  {
  }

TOPAlignerModule()

TOPAlignerModule

(

)

Constructor.

Definition at line 44 of file TOPAlignerModule.cc.

                                     : Module()
 
  {
    // set module description
    setDescription("Alignment of TOP");
    //    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("targetModule", m_targetMid,
             "Module to be aligned. Must be 1 <= Mid <= 16.", 1);
    addParam("maxFails", m_maxFails,
             "Maximum number of consecutive failed iterations before resetting the procedure", 100);
    addParam("sample", m_sample,
             "sample type: one of dimuon, bhabha or cosmics", std::string("dimuon"));
    addParam("minMomentum", m_minMomentum,
             "minimal track momentum if sample is cosmics", 1.0);
    addParam("deltaEcms", m_deltaEcms,
             "c.m.s energy window (half size) if sample is dimuon or bhabha", 0.1);
    addParam("dr", m_dr, "cut on POCA in r", 2.0);
    addParam("dz", m_dz, "cut on POCA in abs(z)", 4.0);
    addParam("minZ", m_minZ,
             "minimal local z of extrapolated hit", -130.0);
    addParam("maxZ", m_maxZ,
             "maximal local z of extrapolated hit", 130.0);
    addParam("outFileName", m_outFileName,
             "Root output file name containing alignment results",
             std::string("TopAlignPars.root"));
    addParam("stepPosition", m_stepPosition, "step size for translations", 1.0);
    addParam("stepAngle", m_stepAngle, "step size for rotations", 0.01);
    addParam("stepTime", m_stepTime, "step size for t0", 0.05);
    std::string names;
    for (const auto& parName : m_align.getParameterNames()) names += parName + ", ";
    names.pop_back();
    names.pop_back();
    addParam("parInit", m_parInit,
             "initial parameter values in the order [" + names + "]. "
             "If list is too short, the missing ones are set to 0.", m_parInit);
    auto parFixed = m_parFixed;
    addParam("parFixed", m_parFixed, "list of names of parameters to be fixed. "
             "Valid names are: " + names, parFixed);
 
  }

TOPAlignmentCollectorModule()

TOPAlignmentCollectorModule

(

)

Constructor.

Definition at line 42 of file TOPAlignmentCollectorModule.cc.

  {
    // set module description and processing properties
    setDescription("A collector for geometrical alignment of a TOP module with dimuons or Bhabhas. Iterative alignment procedure (NIMA 876 (2017) 260-264) is run here, algorithm just collects the results.");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // module parameters
    addParam("targetModule", m_targetMid,
             "Module to be aligned. Must be 1 <= Mid <= 16.");
    addParam("maxFails", m_maxFails,
             "Maximum number of consecutive failed iterations before resetting the procedure", 100);
    addParam("sample", m_sample,
             "sample type: one of dimuon or bhabha", std::string("dimuon"));
    addParam("deltaEcms", m_deltaEcms,
             "c.m.s energy window (half size) if sample is dimuon or bhabha", 0.1);
    addParam("dr", m_dr, "cut on POCA in r", 1.0);
    addParam("dz", m_dz, "cut on POCA in abs(z)", 2.0);
    addParam("minZ", m_minZ, "minimal local z of extrapolated hit", -130.0);
    addParam("maxZ", m_maxZ, "maximal local z of extrapolated hit", 130.0);
    addParam("stepPosition", m_stepPosition, "step size for translations", 1.0);
    addParam("stepAngle", m_stepAngle, "step size for rotations", 0.01);
    addParam("stepTime", m_stepTime, "step size for t0", 0.05);
    std::string names;
    auto align = ModuleAlignment();
    for (const auto& parName : align.getParameterNames()) names += parName + ", ";
    names.pop_back();
    names.pop_back();
    addParam("parInit", m_parInit,
             "initial parameter values in the order [" + names + "]. "
             "If list is too short, the missing ones are set to 0.", m_parInit);
    auto parFixed = m_parFixed;
    addParam("parFixed", m_parFixed, "list of names of parameters to be fixed. "
             "Valid names are: " + names, parFixed);
 
  }

TOPAsicShiftsBS13dCollectorModule()

TOPAsicShiftsBS13dCollectorModule

(

)

Constructor.

Definition at line 36 of file TOPAsicShiftsBS13dCollectorModule.cc.

  {
    // set module description and processing properties
    setDescription("A collector for calibration of carrier shifts of BS13d.");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // module parameters
    addParam("timeOffset", m_timeOffset, "time offset", 0.0);
    addParam("nx", m_nx, "number of histogram bins (bin size ~8 ns)", 50);
    addParam("requireRecBunch", m_requireRecBunch,
             "if True, require reconstructed bunch (to be used on cdst files only!)",
             false);
 
  }

TOPBackgroundModule()

TOPBackgroundModule

(

)

Constructor.

Definition at line 60 of file TOPBackgroundModule.cc.

                                           : Module(),
    m_rootFile(0),
    origingamma(0),
    originpe(0),
    peflux(0),
    nflux(0),
    rdose(0),
    zdist(0),
    genergy(0),
    genergy2(0),
    zdistg(0),
    originpt(0),
    nflux_bar(0),
    gflux_bar(0),
    cflux_bar(0),
    norigin(0),
    gorigin(0),
    corigin(0),
    nprim(0),
    gprim(0),
    cprim(0),
    origin_zx(0),
    origin_zy(0),
    prim_zx(0),
    prim_zy(0),
    module_occupancy(0),
    PCBmass(0),
    PCBarea(0),
    yearns(0),
    evtoJ(0),
    mtoc(0),
    count(0),
    count_occ(0),
    origingamma_x(0),
    origingamma_y(0),
    origingamma_z(0),
    originpe_x(0),
    originpe_y(0),
    originpe_z(0)
  {
    // Set description()
    setDescription("A module to analyze beam background simulations regarding TOP");
 
    // Add parameters
    addParam("Type", m_BkgType, "Backgound type", string("Backgound"));
    addParam("Output", m_OutputFileName, "Name of the output file",
             string("Backgound.root"));
    addParam("TimeOfSimulation", m_TimeOfSimulation,
             "Real time in micro seconds that corresponds to simulated data", 5.);
  }

TOPBunchFinderModule()

TOPBunchFinderModule

(

)

Constructor.

Definition at line 53 of file TOPBunchFinderModule.cc.

                                             : Module()
  {
    // set module description (e.g. insert text)
    setDescription("A precise event T0 determination w.r.t local time reference of TOP counter. "
                   "Results available in TOPRecBunch.");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("numBins", m_numBins, "number of bins of fine search region", 200);
    addParam("timeRangeFine", m_timeRangeFine,
             "time range in which to do fine search [ns]", 10.0);
    addParam("timeRangeCoarse", m_timeRangeCoarse,
             "time range in which to do coarse search, if autoRange turned off [ns]", 100.0);
    addParam("autoRange", m_autoRange,
             "turn on/off automatic determination of the coarse search region (false means off)", false);
    addParam("sigmaSmear", m_sigmaSmear,
             "sigma in [ns] for additional smearing of PDF", 0.0);
    addParam("minSignal", m_minSignal,
             "minimal number of signal photons to accept track", 8.0);
    addParam("minSBRatio", m_minSBRatio,
             "minimal signal-to-background ratio to accept track", 0.0);
    addParam("minDERatio", m_minDERatio,
             "minimal ratio of detected-to-expected photons to accept track", 0.2);
    addParam("maxDERatio", m_maxDERatio,
             "maximal ratio of detected-to-expected photons to accept track", 2.5);
    addParam("minPt", m_minPt, "minimal p_T of the track", 0.3);
    addParam("maxPt", m_maxPt, "maximal p_T of the track", 6.0);
    addParam("maxD0", m_maxD0, "maximal absolute value of helix perigee distance", 2.0);
    addParam("maxZ0", m_maxZ0, "maximal absolute value of helix perigee z coordinate", 4.0);
    addParam("minNHitsCDC", m_minNHitsCDC, "minimal number of hits in CDC", 20);
    addParam("useMCTruth", m_useMCTruth,
             "if true, use MC truth for particle mass instead of the most probable from dEdx",
             false);
    addParam("saveHistograms", m_saveHistograms,
             "if true, save histograms to TOPRecBunch and TOPTimeZeros", false);
    addParam("tau", m_tau,
             "first order filter time constant [number of events]", 100.0);
    addParam("correctDigits", m_correctDigits,
             "if true, subtract bunch time in TOPDigits", true);
    addParam("subtractRunningOffset", m_subtractRunningOffset,
             "if true and correctDigits = True, subtract running offset in TOPDigits "
             "when running in HLT mode. It must be set to false when running calibration.",
             true);
    addParam("bunchesPerSSTclk", m_bunchesPerSSTclk,
             "number of bunches per SST clock period", 24);
    addParam("usePIDLikelihoods", m_usePIDLikelihoods,
             "use PIDLikelihoods instead of DedxLikelihoods (only if run on cdst files)",
             false);
    addParam("nTrackLimit", m_nTrackLimit,
             "maximum number of tracks (inclusive) to use three particle hypotheses in fine search "
             "(only when running in data processing mode).", unsigned(3));
    addParam("useTimeSeed",  m_useTimeSeed, "use SVD or CDC event T0 as a seed "
             "(only when running in data processing mode and autoRange turned off).", true);
    addParam("useFillPattern", m_useFillPattern, "use known accelerator fill pattern to enhance efficiency "
             "(only when running in data processing mode).", true);
  }

TOPCalPulseGeneratorModule()

TOPCalPulseGeneratorModule

(

)

Constructor.

Definition at line 45 of file TOPCalPulseGeneratorModule.cc.

                                                         : Module()
 
  {
    // set module description
    setDescription("Realistic generator of calibration double pulses. "
                   "Needs TOPDigitizer to digitize");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("moduleIDs", m_moduleIDs,
             "list of slots for which to generate cal pulse, empty list means all slots.",
             m_moduleIDs);
    m_asicChannels.push_back(0);
    addParam("asicChannels", m_asicChannels,
             "ASIC calibration channels (0 - 7), empty list means all channels.",
             m_asicChannels);
    // default for these three below are set according to laser run 8/414
    addParam("amplitude", m_amplitude, "amplitude of cal pulse [ADC counts]", 600.0);
    addParam("delay", m_delay, "delay of cal pulse [ns]", 10.5);
    addParam("windowSize", m_windowSize, "size of time window in which to generate cal pulses [ns]", 8.0);
  }

TOPChannelMaskCollectorModule()

TOPChannelMaskCollectorModule

(

)

Constructor.

Definition at line 31 of file TOPChannelMaskCollectorModule.cc.

  {
    // set module description and processing properties
    setDescription("A collector for preparing masks of dead and hot channels");
    setPropertyFlags(c_ParallelProcessingCertified);
  }

TOPChannelMaskerModule()

TOPChannelMaskerModule

(

)

Constructor: Sets the description of the module.

Definition at line 32 of file TOPChannelMaskerModule.cc.

                                                 : Module()
  {
    // Set module properties
    setDescription("Masks dead, hot and uncalibrated channels from the reconstruction");
 
    // Set property flags
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("maskUncalibratedChannelT0", m_maskUncalibratedChannelT0,
             "if true, mask channelT0-uncalibrated channels", true);
    addParam("maskUncalibratedTimebase", m_maskUncalibratedTimebase,
             "if true, mask timebase-uncalibrated channels ", true);
  }

TOPChannelT0CalibratorModule()

TOPChannelT0CalibratorModule

(

)

Constructor.

Definition at line 38 of file TOPChannelT0CalibratorModule.cc.

                                                             : Module()
 
  {
    // set module description
    setDescription("Alternative channel T0 calibration with dimuons or bhabhas. "
                   "This module can also be used to check the calibration "
                   "(channel, module and common T0).\n"
                   "Note: after this kind of calibration one cannot do the alignment.");
    //    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("numBins", m_numBins, "number of bins of the search region", 200);
    addParam("timeRange", m_timeRange,
             "time range in which to search for the minimum [ns]", 10.0);
    addParam("sigmaSmear", m_sigmaSmear,
             "sigma in [ns] for additional smearing of PDF", 0.0);
    addParam("sample", m_sample,
             "sample type: one of dimuon, bhabha or cosmics", std::string("dimuon"));
    addParam("minMomentum", m_minMomentum,
             "minimal track momentum if sample is cosmics", 1.0);
    addParam("deltaEcms", m_deltaEcms,
             "c.m.s energy window (half size) if sample is dimuon or bhabha", 0.1);
    addParam("dr", m_dr, "cut on POCA in r", 2.0);
    addParam("dz", m_dz, "cut on POCA in abs(z)", 4.0);
    addParam("minZ", m_minZ,
             "minimal local z of extrapolated hit", -130.0);
    addParam("maxZ", m_maxZ,
             "maximal local z of extrapolated hit", 130.0);
    addParam("outputFileName", m_outFileName,
             "Root output file name containing calibration results. "
             "File name can include *'s; "
             "they will be replaced with a run number from the first input file",
             std::string("calibrationT0_r*.root"));
    addParam("pdfOption", m_pdfOption,
             "PDF option, one of 'rough', 'fine', 'optimal'", std::string("rough"));
 
  }

TOPChannelT0MCModule()

TOPChannelT0MCModule

(

)

Constructor.

Definition at line 40 of file TOPChannelT0MCModule.cc.

                                             : Module()
  {
    std::vector<double> frange = {100, 0., 1.};
    // set module description (e.g. insert text)
    setDescription("TOP channel T0 Calibration of MC extraction");
    // Add parameters
    addParam("outputFile", m_outputFile, "Output root file name",
             string(""));
    addParam("fitRange", m_fitRange, "fit range[nbins, xmin, xmax]", frange);
 
  }

TOPCommonT0BFCollectorModule()

TOPCommonT0BFCollectorModule

(

)

Constructor.

Definition at line 35 of file TOPCommonT0BFCollectorModule.cc.

  {
    // set module description and processing properties
    setDescription("A collector for common T0 calibration with a fit of bunch finder residuals (method BF)");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // module parameters
    addParam("bunchesPerSSTclk", m_bunchesPerSSTclk,
             "number of bunches per SST clock period", 24);
    addParam("nx", m_nx, "number of histogram bins", 200);
 
  }

TOPCommonT0CalibratorModule()

TOPCommonT0CalibratorModule

(

)

Constructor.

Definition at line 37 of file TOPCommonT0CalibratorModule.cc.

                                                           : Module()
 
  {
    // set module description
    setDescription("Common T0 calibration with dimuons or bhabhas.");
    //    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("numBins", m_numBins, "number of bins of the search region", 200);
    addParam("timeRange", m_timeRange,
             "time range in which to search for the minimum [ns]", 10.0);
    addParam("sigmaSmear", m_sigmaSmear,
             "sigma in [ns] for additional smearing of PDF", 0.0);
    addParam("sample", m_sample,
             "sample type: one of dimuon, bhabha or cosmics", std::string("dimuon"));
    addParam("minMomentum", m_minMomentum,
             "minimal track momentum if sample is cosmics", 1.0);
    addParam("deltaEcms", m_deltaEcms,
             "c.m.s energy window (half size) if sample is dimuon or bhabha", 0.1);
    addParam("dr", m_dr, "cut on POCA in r", 2.0);
    addParam("dz", m_dz, "cut on POCA in abs(z)", 4.0);
    addParam("minZ", m_minZ,
             "minimal local z of extrapolated hit", -130.0);
    addParam("maxZ", m_maxZ,
             "maximal local z of extrapolated hit", 130.0);
    addParam("outputFileName", m_outFileName,
             "Root output file name containing calibration results. "
             "File name can include *'s; "
             "they will be replaced with a run number from the first input file",
             std::string("commonT0_r*.root"));
    addParam("pdfOption", m_pdfOption,
             "PDF option, one of 'rough', 'fine', 'optimal'", std::string("rough"));
 
  }

TOPCommonT0LLCollectorModule()

TOPCommonT0LLCollectorModule

(

)

Constructor.

Definition at line 45 of file TOPCommonT0LLCollectorModule.cc.

  {
    // set module description and processing properties
    setDescription("A collector for common T0 calibration with dimuons or Bhabha's using "
                   "neg. log likelihood minimization (method LL)");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // module parameters
    addParam("bunchesPerSSTclk", m_bunchesPerSSTclk,
             "number of bunches per SST clock period", 24);
    addParam("numBins", m_numBins, "number of bins of the search region", 200);
    addParam("timeRange", m_timeRange,
             "time range in which to search for the minimum [ns]", 10.0);
    addParam("sigmaSmear", m_sigmaSmear,
             "sigma in [ns] for additional smearing of PDF", 0.0);
    addParam("sample", m_sample,
             "sample type: one of dimuon or bhabha", std::string("dimuon"));
    addParam("deltaEcms", m_deltaEcms,
             "c.m.s energy window (half size) if sample is dimuon or bhabha", 0.1);
    addParam("dr", m_dr, "cut on POCA in r", 2.0);
    addParam("dz", m_dz, "cut on POCA in abs(z)", 4.0);
    addParam("minZ", m_minZ,
             "minimal local z of extrapolated hit", -130.0);
    addParam("maxZ", m_maxZ,
             "maximal local z of extrapolated hit", 130.0);
    addParam("pdfOption", m_pdfOption,
             "PDF option, one of 'rough', 'fine', 'optimal'", std::string("rough"));
  }

TOPCosmicT0FinderModule()

TOPCosmicT0FinderModule

(

)

Constructor.

Definition at line 56 of file TOPCosmicT0FinderModule.cc.

                                                   : Module()
 
  {
    // set module description
    setDescription("Event T0 finder for global cosmic runs");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("useIncomingTrack", m_useIncomingTrack,
             "if true, use incoming track, otherwise use outcoming track", true);
    addParam("minHits", m_minHits,
             "minimal number of detected photons in a module", (unsigned) 10);
    addParam("minSignal", m_minSignal,
             "minimal number of expected signal photons", 5.0);
    addParam("applyT0", m_applyT0, "if true, subtract T0 in TOPDigits", true);
    addParam("numBins", m_numBins, "number of bins time range is divided to", 200);
    addParam("timeRange", m_timeRange, "time range in which to search [ns]", 10.0);
    addParam("sigma", m_sigma, "additional time spread added to PDF [ns]", 0.0);
    addParam("saveHistograms", m_saveHistograms,
             "save histograms to TOPTimeZero", false);
  }

TOPDigitizerModule()

TOPDigitizerModule

(

)

Constructor.

Definition at line 50 of file TOPDigitizerModule.cc.

                                         : Module()
  {
    // Set description()
    setDescription("Digitize TOPSimHits");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("timeZeroJitter", m_timeZeroJitter,
             "r.m.s of T0 jitter [ns]", 15e-3);
    addParam("electronicJitter", m_electronicJitter,
             "r.m.s of electronic jitter [ns], "
             "if negative the one from TOPNominalTDC is used. "
             "This parameter is ignored in the full waveform digitization.", -1.0);
    addParam("darkNoise", m_darkNoise,
             "uniformly distributed dark noise (hits per module)", 0.0);
    addParam("ADCx0", m_ADCx0,
             "pulse height distribution parameter [ADC counts]", 204.1);
    addParam("ADCp1", m_ADCp1,
             "pulse height distribution parameter (must be non-negative)", 1.0);
    addParam("ADCp2", m_ADCp2,
             "pulse height distribution parameter (must be non-negative)", 1.025);
    addParam("ADCmax", m_ADCmax,
             "pulse height distribution upper bound [ADC counts]", 2000.0);
    addParam("rmsNoise", m_rmsNoise,
             "r.m.s of noise [ADC counts]", 9.7);
    addParam("threshold", m_threshold,
             "pulse height threshold [ADC counts]", 40);
    addParam("hysteresis", m_hysteresis,
             "pulse height threshold hysteresis [ADC counts]", 10);
    addParam("thresholdCount", m_thresholdCount,
             "minimal number of samples above threshold", 3);
    addParam("useWaveforms", m_useWaveforms,
             "if true, use full waveform digitization", true);
    addParam("allChannels", m_allChannels,
             "if true, make waveforms for all 8192 channels "
             "(note: this will slow-down digitization)", false);
    addParam("useDatabase", m_useDatabase,
             "if true, use channel dependent constants from database (incl. time base)",
             true);
    addParam("useSampleTimeCalibration", m_useSampleTimeCalibration,
             "if true, use only time base calibration from database "
             "(has no effect if useDatabase = True)", false);
    addParam("simulateTTS", m_simulateTTS,
             "if true, simulate time transition spread. "
             "Should be always switched ON, except for some dedicated timing studies.",
             true);
    addParam("minWidthXheight", m_minWidthXheight,
             "minimal product of width and height [ns * ADC counts]", 100.0);
    addParam("lookBackWindows", m_lookBackWindows,
             "number of look back windows, if positive override the number from database", 0);
  }

TOPDoublePulseGeneratorModule()

TOPDoublePulseGeneratorModule

(

)

Constructor.

Definition at line 52 of file TOPDoublePulseGeneratorModule.cc.

                                                               : Module()
 
  {
    // set module description
    setDescription("Generator of calibration double pulses");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("moduleIDs", m_moduleIDs,
             "list of slots for which to generate cal pulse, empty list means all slots.",
             m_moduleIDs);
    m_asicChannels.push_back(0);
    addParam("asicChannels", m_asicChannels,
             "ASIC calibration channels (0 - 7), empty list means all channels.",
             m_asicChannels);
    addParam("timeDifference", m_timeDifference,
             "time difference between first and second pulse [ns].", 21.87);
    addParam("timeResolution", m_timeResolution,
             "sigma of time difference [ns].", 40.0e-3);
    addParam("sampleTimeIntervals", m_sampleTimeIntervals,
             "vector of 256 sample time intervals to construct sample times. "
             "If empty, equidistant intervals will be used.", m_sampleTimeIntervals);
    addParam("useDatabase", m_useDatabase,
             "if true, use sample times from database instead of sampleTimeIntervals.",
             false);
    addParam("storageWindows", m_storageWindows,
             "number of storage windows (old FW used 64 out of 512)", (unsigned) 512);
    addParam("outputFileName", m_outputFileName,
             "if given, sample times will be saved as root histograms in this file",
             std::string(""));
 
  }

TOPDQMModule()

TOPDQMModule

(

)

Constructor.

Definition at line 41 of file TOPDQMModule.cc.

                             : HistoModule()
  {
    // set module description (e.g. insert text)
    setDescription("TOP DQM histogrammer");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("histogramDirectoryName", m_histogramDirectoryName,
             "histogram directory in ROOT file", string("TOP"));
    addParam("momentumCut", m_momentumCut,
             "momentum cut used to histogram number of photons per track", 0.5);
  }

TOPGainEfficiencyCalculatorModule()

TOPGainEfficiencyCalculatorModule

(

)

Constructor.

Definition at line 47 of file TOPGainEfficiencyCalculatorModule.cc.

                                                                       : HistoModule()
  {
    // Set description()
    setDescription("Calculate pixel gain and efficiency for a given PMT from 2D histogram of hit timing and pulse charge, "
                   "created by TOPLaserHitSelectorModule.");
 
    // Add parameters
    addParam("inputFile", m_inputFile, "input file name containing 2D histogram", std::string(""));
    addParam("outputPDFFile", m_outputPDFFile, "output PDF file to store plots", std::string(""));
    addParam("targetSlotId", m_targetSlotId, "TOP module ID in slot number (1-16)", (short)0);
    addParam("targetPmtId", m_targetPmtId, "PMT number (1-32)", (short)0);
    addParam("targetPmtChId", m_targetPmtChId, "PMT channel number (1-16)", (short) - 1);
    addParam("hvDiff", m_hvDiff, "HV difference from nominal HV value", (short)0);
    addParam("fitHalfWidth", m_fitHalfWidth, "half fit width for direct laser hit peak in [ns] unit", (float)1.0);
    addParam("threshold", m_threshold,
             "pulse height (or integrated charge) threshold in fitting its distribution and calculating efficiency", (float)100.);
    addParam("p0HeightIntegral", m_p0HeightIntegral,
             "Parameter from p0 + x*p1 function fitting height-integral distribtion.", (float) - 50.0);
    addParam("p1HeightIntegral", m_p1HeightIntegral,
             "Parameter from p0 + x*p1 function fitting height-integral distribtion.", (float)6.0);
    addParam("fracFit", m_fracFit, "fraction of events to be used in fitting. "
             "An upper limit of a fit range is given to cover this fraction of events. "
             "Set negative value to calculate the fraction to exclude only 10 events in tail.", (float)(-1)); //,(float)0.99);
    addParam("initialP0", m_initialP0, "initial value of the fit parameter p0 divided by histogram entries."
             "Set negative value to calculate from histogram inforamtion automatically.", (float)(0.0001)); //,(float)1e-6);
    addParam("initialP1", m_initialP1, "initial value of the fit parameter p1."
             "Set negative value to calculate from histogram inforamtion automatically.", (float)(1.0)); //,(float)1.0);
    addParam("initialP2", m_initialP2, "initial value of the fit parameter p2."
             "Set negative value to calculate from histogram inforamtion automatically.", (float)(1.0)); //,(float)1.0);
    addParam("initialX0", m_initialX0, "initial value of the fit parameter x0 divided by histogram bin width."
             "Set negative value to calculate from histogram inforamtion automatically.", (float)(100)); //, (float)100.);
    addParam("pedestalSigma", m_pedestalSigma, "sigma of pedestal width", (float)10.);
    addParam("fitoption", m_fitoption, "fit option likelihood: default chisquare: R", std::string("L"));
 
  }

TOPGainFunc()

double TOPGainFunc ( double *  var, double *  par  )

static

Fit function of pulse charge (or charnge) distribution for channel(pixel)-by-channel gain extraction, given by "[0]*pow(x-[4],[1])*exp(-pow(x-[4],[2])/[3])" smeared by Gaussian with a constant sigma to consider baseline fluctuation.

Definition at line 625 of file TOPGainEfficiencyCalculatorModule.cc.

  {
 
    double pedestal = par[4];
    double pedestalWidth = par[5];
    double x = (var[0] - pedestal);
 
    double output = 0;
    double step = pedestalWidth / 100.;
    double t = TMath::Max(step, x - pedestalWidth * 10);
    //double t = TMath::Max( g_xStep, x ); //for test
    while (t < x + pedestalWidth * 10) {
      output += TMath::Gaus(x, t, pedestalWidth) * TMath::Power(t / par[3], par[1])
                * TMath::Exp((-1) * TMath::Power(t / par[3], par[2]));
      t += step;
    }
    //  TF1* func = new TF1( "func", "[0]*pow(x-[4],[1])*exp(-pow(x-[4],[2])/[3])",
 
    return par[0] * output * step;
  }

TOPGeometryParInitializerModule()

TOPGeometryParInitializerModule

(

)

Constructor.

Definition at line 39 of file TOPGeometryParInitializerModule.cc.

                                                                   : Module()
 
  {
    // set module description
    setDescription("Class for initializing TOPGeometryPar. "
                   "This class is by default initialized when Geant geometry is created. "
                   "Useful if Geant geometry is not needed. Be carefull when using!");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("useDB", m_useDB,
             "If true load the Geometry from the database instead of the gearbox", true);
  }

TOPInterimFENtupleModule()

TOPInterimFENtupleModule

(

)

Constructor.

Definition at line 47 of file TOPInterimFENtupleModule.cc.

                                                     : HistoModule()
  {
    setDescription("Create ntuple mainly from TOPDigit with double pulse identification. "
                   "Data taken with both InterimFE FW and production FW are available. (since Jan, 2017)");
 
    addParam("calibrationChannel", m_calibrationChannel, "asic channel # where calibration pulses routed",
             (unsigned)0);
    addParam("saveWaveform", m_saveWaveform, "whether to save waveform data or not",
             (bool)false);
    addParam("useDoublePulse", m_useDoublePulse,
             "set true when you require both of double calibration pulses for reference timing. You need to enable offline feature extraction.",
             (bool)true);
    //  addParam("averageSamplingRate", m_averageSamplingRate, "sampling rate with assumption of uniform interval in a unit of GHz",
    //           (float)2.71394);
    addParam("minHeightFirstCalPulse", m_calibrationPulseThreshold1, "pulse height threshold for the first cal. pulse",
             (float)600.);
    addParam("minHeightSecondCalPulse", m_calibrationPulseThreshold2, "pulse height threshold for the second cal. pulse",
             (float)450.);
    addParam("nominalDeltaT", m_calibrationPulseInterval, "nominal DeltaT (time interval of the double calibration pulses) [ns]",
             (float)21.85);
    addParam("nominalDeltaTRange", m_calibrationPulseIntervalRange,
             "acceptable DeltaT shift from the noinal value before calibration [ns]",
             (float)2.);
    addParam("globalRefSlotNum", m_globalRefSlotNum,
             "slot number where a global reference asic exists. slot01-asic0 (pixelId=1-8) is default.", 1);
    addParam("globalRefAsicNum", m_globalRefAsicNum,
             "asic number defined as int((pixelId-1)/8) of a global reference asic", 0);
 
    addParam("timePerWin", m_timePerWin, "time interval of a single window (=64 samples) [ns]", (float)23.581939);
  }

TOPLaserCalibratorModule()

TOPLaserCalibratorModule

(

)

Constructor.

Definition at line 49 of file TOPLaserCalibratorModule.cc.

                                                     : Module()
  {
    setDescription("T0 Calibration using the laser calibration system");
 
    std::vector<double> frange = {100, 0., 1.};
    // Add parameters
    addParam("dataFitOutput", m_dataFitOutput, "Output root file for data",
             string("")); //output fitting results
    addParam("mcInput", m_mcInput, "Input root file from MC", string(""));
    addParam("channelT0constant", m_chT0C, "Output of channel T0 constant", string(""));
    addParam("fitChannel", m_fitChannel, "set 0 - 511 to a specific channel; set 0 to all channels in the fit",
             512);
    addParam("barID", m_barID, "ID of TOP module to calibrate");
    addParam("refCh", m_refCh, "reference channel of T0 constant");
    addParam("fitMethod", m_fitMethod, "gauss: single gaussian; cb: single Crystal Ball; cb2: double Crystal Ball", string("gauss"));
    addParam("fitRange", m_fitRange, "fit range[nbins, xmin, xmax]", frange);
 
    for (int i = 0; i < c_NumChannels; ++i) {
      m_histo[i] = 0;
    }
  }

TOPLaserHitSelectorModule()

TOPLaserHitSelectorModule

(

)

Constructor.

Definition at line 44 of file TOPLaserHitSelectorModule.cc.

                                                       : HistoModule()
  {
    // Set description()
    setDescription("TOP pixel-by-pixel gain analysis - first step : create hit timing-pulse charge histogram");
 
    // Add parameters
    m_timeHistogramBinning.push_back(140);//140 for time axis
    m_timeHistogramBinning.push_back(-55);//-25
    m_timeHistogramBinning.push_back(15);//45
    m_chargeHistogramBinning.push_back(125);//for height
    m_chargeHistogramBinning.push_back(-50);//
    m_chargeHistogramBinning.push_back(2450);//
    m_chargeHistogramBinning.push_back(150);//for integral
    m_chargeHistogramBinning.push_back(-500);//
    m_chargeHistogramBinning.push_back(29500);//
 
    addParam("timeHistogramBinning", m_timeHistogramBinning,
             "histogram binning (the number of bins, lower limit, upper limit) for hit timing distribution (should be integer value)",
             m_timeHistogramBinning);
    addParam("chargeHistogramBinning", m_chargeHistogramBinning,
             "histogram binning (the number of bins, lower limit, upper limit) for pulse charge distribution (should be integer value)",
             m_chargeHistogramBinning);
 
    //  addParam("calibrationChannel", m_calibrationChannel, "asic channel # where calibration pulses routed",
    //           (unsigned)0);
    addParam("useDoublePulse", m_useDoublePulse,
             "set true when you require both of double calibration pulses for reference timing. You need to enable offline feature extraction.",
             (bool)true);
    addParam("minHeightFirstCalPulse", m_calibrationPulseThreshold1, "pulse height threshold for the first cal. pulse",
             (float)300.);
    addParam("minHeightSecondCalPulse", m_calibrationPulseThreshold2, "pulse height threshold for the second cal. pulse",
             (float)100.);
    addParam("nominalDeltaT", m_calibrationPulseInterval, "nominal DeltaT (time interval of the double calibration pulses) [ns]",
             (float)25.5);
    addParam("nominalDeltaTRange", m_calibrationPulseIntervalRange,
             "acceptable DeltaT range from the nominal value before calibration [ns]",
             (float)2.);
    addParam("windowSelect", m_windowSelect,
             "select window number (All=0, Odd=2, Even=1)",
             0);
    addParam("includePrimaryChargeShare", m_includePrimaryChargeShare,
             "set ture when you require without primary chargeshare cut for making 2D histogram",
             (bool)false);
    addParam("includeAllChargeShare", m_includeAllChargeShare,
             "set ture when you require without all chargeshare cut for making 2D histogram",
             (bool)false);
  }

TOPMCTrackMakerModule()

TOPMCTrackMakerModule

(

)

Constructor.

Definition at line 45 of file TOPMCTrackMakerModule.cc.

                                               : Module()
 
  {
    // set module description (e.g. insert text)
    setDescription("Constructs Tracks and ExtHits from MCParticles and TOPBarHits. "
                   "Utility needed for testing and debugging of TOP reconstruction.");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
 
  }

TOPModuleT0CalibratorModule()

TOPModuleT0CalibratorModule

(

)

Constructor.

Definition at line 36 of file TOPModuleT0CalibratorModule.cc.

                                                           : Module()
 
  {
    // set module description
    setDescription("Module T0 calibration with dimuons or bhabhas. "
                   "Useful when the geometrical alignment is fine.");
    //    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("numBins", m_numBins, "number of bins of the search region", 200);
    addParam("timeRange", m_timeRange,
             "time range in which to search for the minimum [ns]", 10.0);
    addParam("sigmaSmear", m_sigmaSmear,
             "sigma in [ns] for additional smearing of PDF", 0.0);
    addParam("sample", m_sample,
             "sample type: one of dimuon, bhabha or cosmics", std::string("dimuon"));
    addParam("minMomentum", m_minMomentum,
             "minimal track momentum if sample is cosmics", 1.0);
    addParam("deltaEcms", m_deltaEcms,
             "c.m.s energy window (half size) if sample is dimuon or bhabha", 0.1);
    addParam("dr", m_dr, "cut on POCA in r", 2.0);
    addParam("dz", m_dz, "cut on POCA in abs(z)", 4.0);
    addParam("minZ", m_minZ,
             "minimal local z of extrapolated hit", -130.0);
    addParam("maxZ", m_maxZ,
             "maximal local z of extrapolated hit", 130.0);
    addParam("outputFileName", m_outFileName,
             "Root output file name containing calibration results. "
             "File name can include *'s; "
             "they will be replaced with a run number from the first input file",
             std::string("moduleT0_r*.root"));
    addParam("pdfOption", m_pdfOption,
             "PDF option, one of 'rough', 'fine', 'optimal'", std::string("rough"));
 
  }

TOPModuleT0DeltaTCollectorModule()

TOPModuleT0DeltaTCollectorModule

(

)

Constructor.

Definition at line 32 of file TOPModuleT0DeltaTCollectorModule.cc.

  {
    // set module description and processing properties
    setDescription("A collector for module T0 calibration with chi2 minimization of "
                   "time differences between slots (method DeltaT). Useful for initial "
                   "(rough) calibration, since the results are found slightly biased. "
                   "For the final (precise) calibration one has to use LL method.");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // module parameters
    addParam("numBins", m_numBins,
             "number of bins of histograms of time difference", 400);
    addParam("timeRange", m_timeRange,
             "time range [ns] of histograms of time difference", 20.0);
 
  }

TOPModuleT0LLCollectorModule()

TOPModuleT0LLCollectorModule

(

)

Constructor.

Definition at line 45 of file TOPModuleT0LLCollectorModule.cc.

  {
    // set module description and processing properties
    setDescription("A collector for module T0 calibration with neg. log likelihood "
                   "minimization (method LL). Aimed for the final (precise) calibration"
                   "after initial one with DeltaT method.");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // module parameters
    addParam("numBins", m_numBins, "number of bins of the search region", 200);
    addParam("timeRange", m_timeRange,
             "time range in which to search for the minimum [ns]", 10.0);
    addParam("sigmaSmear", m_sigmaSmear,
             "sigma in [ns] for additional smearing of PDF", 0.0);
    addParam("sample", m_sample,
             "sample type: one of dimuon or bhabha", std::string("dimuon"));
    addParam("deltaEcms", m_deltaEcms,
             "c.m.s energy window (half size) if sample is dimuon or bhabha", 0.1);
    addParam("dr", m_dr, "cut on POCA in r", 2.0);
    addParam("dz", m_dz, "cut on POCA in abs(z)", 4.0);
    addParam("minZ", m_minZ,
             "minimal local z of extrapolated hit", -130.0);
    addParam("maxZ", m_maxZ,
             "maximal local z of extrapolated hit", 130.0);
    addParam("pdfOption", m_pdfOption,
             "PDF option, one of 'rough', 'fine', 'optimal'", std::string("rough"));
 
  }

TOPNtupleModule()

TOPNtupleModule

(

)

Constructor.

Definition at line 57 of file TOPNtupleModule.cc.

                                   : Module()
  {
    // set module description
    setDescription("Writes ntuple of TOPLikelihoods with tracking info into a root file");
 
    // Add parameters
    addParam("outputFileName", m_outputFileName, "Output file name",
             string("TOPNtuple.root"));
 
  }

TOPOffsetCollectorModule()

TOPOffsetCollectorModule

(

)

Constructor.

Definition at line 32 of file TOPOffsetCollectorModule.cc.

  {
    // set module description and processing properties
    setDescription("A collector for eventT0 and fill pattern offset calibrations");
    setPropertyFlags(c_ParallelProcessingCertified);
 
  }

TOPPackerModule()

TOPPackerModule

(

)

Constructor.

Definition at line 48 of file TOPPackerModule.cc.

                                   : Module()
  {
    // set module description (e.g. insert text)
    setDescription("Raw data packer for TOP");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("inputDigitsName", m_inputDigitsName,
             "name of TOPDigit store array", string(""));
    addParam("inputRawDigitsName", m_inputRawDigitsName,
             "name of TOPRawDigit store array", string(""));
    addParam("outputRawDataName", m_outputRawDataName,
             "name of RawTOP store array", string(""));
    addParam("format", m_format,
             "data format (draft, FE, production)", string("production"));
 
  }

TOPPDFCheckerModule()

TOPPDFCheckerModule

(

)

Constructor.

Definition at line 52 of file TOPPDFCheckerModule.cc.

                                           : HistoModule()
 
  {
    // set module description
    setDescription("Module for checking analytic PDF used in likelihood calculation");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("minTime", m_minTime,
             "histogram lower bound in time [ns]", 0.0);
    addParam("maxTime", m_maxTime,
             "histogram upper bound in time [ns]", 50.0);
    addParam("numBins", m_numBins,
             "histogram number of bins in time", 1000);
 
  }

TOPPDFDebuggerModule()

TOPPDFDebuggerModule

(

)

Constructor.

Definition at line 49 of file TOPPDFDebuggerModule.cc.

                                             : Module()
  {
    // Set description
    setDescription("This module makes an analytic PDF available in "
                   "a store array TOPPDFCollections, related from Tracks");
 
    // Set property flags
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("minTime", m_minTime,
             "lower limit for photon time [ns] (default from DB used, if minTime >= maxTime)", 0.0);
    addParam("maxTime", m_maxTime,
             "upper limit for photon time [ns] (default from DB used, if minTime >= maxTime)", 0.0);
    addParam("pdfOption", m_pdfOption,
             "PDF option, one of 'rough', 'fine', 'optimal'", std::string("fine"));
    addParam("pdgCodes", m_pdgCodes,
             "PDG codes of charged stable particles for which to construct PDF. "
             "Empty list means all charged stable particles.",
             m_pdgCodes);
  }

TOPPhotonYieldsCollectorModule()

TOPPhotonYieldsCollectorModule

(

)

Constructor.

Definition at line 42 of file TOPPhotonYieldsCollectorModule.cc.

  {
    // set module description and processing properties
    setDescription("A collector for photon pixel yields aimed for PMT ageing studies and for finding optically decoupled PMT's");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // module parameters
    addParam("sample", m_sample, "sample type: one of dimuon or bhabha", std::string("dimuon"));
    addParam("deltaEcms", m_deltaEcms, "c.m.s energy window (half size) if sample is dimuon or bhabha", 0.1);
    addParam("dr", m_dr, "cut on POCA in r", 2.0);
    addParam("dz", m_dz, "cut on POCA in abs(z)", 4.0);
    addParam("minThresholdEffi", m_minThresholdEffi, "threshold efficiency cut to suppress unreliable calibrations", 0.7);
 
  }

TOPPulseHeightCollectorModule()

TOPPulseHeightCollectorModule

(

)

Constructor.

Definition at line 31 of file TOPPulseHeightCollectorModule.cc.

  {
    // set module description and processing properties
    setDescription("A collector for channel pulse-height distributions");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // module parameters
    addParam("nx", m_nx, "number of histogram bins", 200);
    addParam("xmax", m_xmax, "histogram upper limit [ADC counts]", 2000.0);
    addParam("pulseWidthWindow", m_widthWindow,
             "lower and upper bound of pulse-width selection window [ns]. "
             "Empty list means no selection on the pulse width. "
             "Note: selection on pulse width will influence pulse-height distribution.",
             m_widthWindow);
    addParam("timeWindow", m_timeWindow,
             "lower and upper bound of time selection window [ns]. "
             "Empty list means no selection on photon time.", m_timeWindow);
 
  }

TOPRawDigitConverterModule()

TOPRawDigitConverterModule

(

)

Constructor.

Definition at line 48 of file TOPRawDigitConverterModule.cc.

                                                         : Module()
 
  {
    // set module description (e.g. insert text)
    setDescription("Converts row digits to digits and applies time calibration");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("inputRawDigitsName", m_inputRawDigitsName,
             "name of TOPRawDigit store array", string(""));
    addParam("outputDigitsName", m_outputDigitsName,
             "name of TOPDigit store array", string(""));
    addParam("useSampleTimeCalibration", m_useSampleTimeCalibration,
             "if true, use sample time calibration", true);
    addParam("useAsicShiftCalibration", m_useAsicShiftCalibration,
             "if true, use ASIC shifts calibration", true);
    addParam("useChannelT0Calibration", m_useChannelT0Calibration,
             "if true, use channel T0 calibration", true);
    addParam("useModuleT0Calibration", m_useModuleT0Calibration,
             "if true, use module T0 calibration", true);
    addParam("useCommonT0Calibration", m_useCommonT0Calibration,
             "if true, use common T0 calibration", true);
    addParam("useTimeWalkCalibration", m_useTimeWalkCalibration,
             "if true, use time-walk calibration", true);
    addParam("pedestalRMS", m_pedestalRMS,
             "r.m.s of pedestals [ADC counts], "
             "if positive, timeError will be estimated from FE data. "
             "This is the default value used if r.m.s is not available from DB.", 9.7);
    addParam("minPulseWidth", m_minPulseWidth,
             "minimal pulse width [ns] to flag digit as good", 1.0);
    addParam("maxPulseWidth", m_maxPulseWidth,
             "maximal pulse width [ns] to flag digit as good", 10.0);
    addParam("minWidthXheight", m_minWidthXheight,
             "minimal product of width and height [ns * ADC counts]", 100.0);
    addParam("storageDepth", m_storageDepth,
             "ASIC analog storage depth of Interim FE format (ignored in other formats)",
             (unsigned) 508);
    addParam("lookBackWindows", m_lookBackWindows,
             "number of look back windows, if positive override the number from database",
             0);
    addParam("setPhase", m_setPhase,
             "if true, set (override) phase in TOPRawDigits", true);
    addParam("calibrationChannel", m_calibrationChannel,
             "calpulse selection: ASIC channel (use -1 to turn off the selection)", -1);
    addParam("calpulseWidthMin", m_calpulseWidthMin,
             "calpulse selection: minimal width [ns]", 0.0);
    addParam("calpulseWidthMax", m_calpulseWidthMax,
             "calpulse selection: maximal width [ns]", 0.0);
    addParam("calpulseHeightMin", m_calpulseHeightMin,
             "calpulse selection: minimal height [ADC counts]", 0);
    addParam("calpulseHeightMax", m_calpulseHeightMax,
             "calpulse selection: maximal height [ADC counts]", 0);
    addParam("calpulseTimeMin", m_calpulseTimeMin,
             "calpulse selection (ON if max > min): minimal time [ns]", 0.0);
    addParam("calpulseTimeMax", m_calpulseTimeMax,
             "calpulse selection (ON if max > min): maximal time [ns]", 0.0);
    addParam("addRelations", m_addRelations, "if true, make relations to TOPRawDigits", true);
 
  }

TOPReconstructorModule()

TOPReconstructorModule

(

)

Constructor.

Definition at line 40 of file TOPReconstructorModule.cc.

                                                 : Module()
  {
    // Set description
    setDescription("Reconstruction for TOP counter. Uses reconstructed tracks "
                   "extrapolated to TOP and TOPDigits to calculate log likelihoods "
                   "for charged stable particles");
 
    // Set property flags
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("minTime", m_minTime,
             "lower limit for photon time [ns] (if minTime >= maxTime use the default from DB)", 0.0);
    addParam("maxTime", m_maxTime,
             "upper limit for photon time [ns] (if minTime >= maxTime use the default from DB)", 0.0);
    addParam("PDGCode", m_PDGCode,
             "PDG code of hypothesis to construct pulls (0 means: use MC truth, -1: switched off)", -1);
    addParam("deltaRayModeling", m_deltaRayModeling,
             "include (True) or exclude (False) delta-ray modeling in log likelihood calculation", false);
    addParam("pTCut", m_pTCut,
             "pT cut to suppress badly extrapolated tracks that cannot reach TOP counter", 0.27);
    addParam("TOPDigitCollectionName", m_topDigitCollectionName,
             "Name of the collection of TOPDigits", string(""));
    addParam("TOPLikelihoodCollectionName", m_topLikelihoodCollectionName,
             "Name of the produced collection of TOPLikelihoods", string(""));
    addParam("TOPPullCollectionName", m_topPullCollectionName, "Name of the collection of produced TOPPulls", string(""));
  }

TOPTBCComparatorModule()

TOPTBCComparatorModule

(

)

Constructor.

Definition at line 41 of file TOPTBCComparatorModule.cc.

                                                 : HistoModule()
  {
    setDescription("TOP Time Base Correction monitor module ");
 
    addParam("inputDirectorList", m_inputDirectoryList,
             "List of the directories (one per IOV) in which the files with the calibration constants of the SCODS are stored. The format of each line must be: folderpath/  label ",
             string(" "));
    addParam("compareToPreviousSet", m_compareToPreviousSet,
             "If true, each CalSet is compared to the previous one in the order determined by the inputDirectorList file. If false, the reference CalSet is the first of the list",
             bool(true));
    addParam("outputFile", m_outputFile,
             "output file containing the monitoring plots", string("TBCComparisonResults.root"));
    addParam("minCalPulses", m_minCalPulses,
             "minimum number of calibration pulses need to flag a sample as non-empty", short(200));
    addParam("numSamples", m_numSamples,
             "number of samples that have been calibrated", short(256));
 
  }

TOPTimeBaseCalibratorModule()

TOPTimeBaseCalibratorModule

(

)

Constructor.

Definition at line 54 of file TOPTimeBaseCalibratorModule.cc.

                                                           : Module()
 
  {
    // set module description
    setDescription("Sample time calibrator");
    //    setPropertyFlags(c_ParallelProcessingCertified | c_InitializeInProcess);
 
    // Add parameters
    addParam("moduleID", m_moduleID, "slot ID to calibrate.");
    addParam("minTimeDiff", m_minTimeDiff,
             "lower bound on time difference [samples].", 0.0);
    addParam("maxTimeDiff", m_maxTimeDiff,
             "upper bound on time difference [samples].", 100.0);
    addParam("directoryName", m_directoryName,
             "name (with path) of the directory for the output root files.",
             string(""));
    addParam("minHits", m_minHits,
             "minimal required hits per channel.", (unsigned) 1000);
    addParam("numIterations", m_numIterations,
             "number of iTBC iterations", (unsigned) 100);
    addParam("numConvIter", m_conv_iter,
             "Max number of iTBC iterations for conversion.", (unsigned) 50);
    addParam("minChi2Change", m_dchi2_min,
             "Minimal of chi2 change in iterations.",  0.2);
    addParam("dtMin", m_dt_min,
             "minimum Delta T of raw calpulse in iTBC",  20.0);
    addParam("dtMax", m_dt_max,
             "maximum Delta T of raw calpulse in iTBC",  24.0);
    addParam("xStep", m_xstep,
             "unit for an interation of delta(X_s)",  0.020);
    addParam("devStep", m_dev_step,
             "a step size to calculate the value of d(chisq)/dxval",  0.001);
    addParam("chgStep", m_change_xstep,
             "update m_xstep if m_dchi2dxv < m_change_step",  0.015);
    addParam("newStep", m_new_xstep,
             "a new step for delta(X_s) if m_dchi2dxv < m_change_step",  2.0 * m_xstep);
    addParam("sigm2_exp", m_sigm2_exp,
             "(sigma_0(dT))**2 for nomarlization of chisq = sum{dT^2/sigma^2}",  0.0424 * 0.0424);
 
    addParam("method", m_method, "method: 0 - profile histograms only, "
             "1 - matrix inversion, 2 - iterative, "
             "3 - matrix inversion w/ singular value decomposition.", (unsigned) 1);
    addParam("useFallingEdge", m_useFallingEdge,
             "if true, use cal pulse falling edge instead of rising edge", false);
    addParam("saveMatrix", m_saveMatrix, "if true, save also matrix and its inverse in a root file", false);
 
  }

TOPTimeRecalibratorModule()

TOPTimeRecalibratorModule

(

)

Constructor.

Definition at line 43 of file TOPTimeRecalibratorModule.cc.

                                                       : Module()
 
  {
    // set module description
    setDescription("Utility module for re-calibrating time of TOPDigits. "
                   "Useful for checking new calibrations on existing cDST files. "
                   "Note that pulseWidth and timeError are not changed "
                   "although they also depend on time calibration.");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("useSampleTimeCalibration", m_useSampleTimeCalibration,
             "if true, use sample time calibration", true);
    addParam("useAsicShiftCalibration", m_useAsicShiftCalibration,
             "if true, use ASIC shifts calibration", true);
    addParam("useChannelT0Calibration", m_useChannelT0Calibration,
             "if true, use channel T0 calibration", true);
    addParam("useModuleT0Calibration", m_useModuleT0Calibration,
             "if true, use module T0 calibration", true);
    addParam("useCommonT0Calibration", m_useCommonT0Calibration,
             "if true, use common T0 calibration", true);
    addParam("useTimeWalkCalibration", m_useTimeWalkCalibration,
             "if true, use time-walk calibration", true);
    addParam("subtractBunchTime", m_subtractBunchTime,
             "if true, subtract reconstructed bunch time", true);
 
  }

TOPTriggerDigitizerModule()

TOPTriggerDigitizerModule

(

)

Constructor.

Definition at line 47 of file TOPTriggerDigitizerModule.cc.

                                                       : Module()
  {
    // Set description()
    setDescription("Digitizer that provides time stamps for TOP trigger");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("threshold", m_threshold,
             "pulse height threshold [ADC counts]", 27);
    addParam("hysteresis", m_hysteresis,
             "pulse height threshold hysteresis [ADC counts]", 10);
    addParam("gateWidth", m_gateWidth,
             "width of discriminator gate [samples]", 8);
    addParam("samplingPhase", m_samplingPhase,
             "sampling phase [samples]", 7);
  }

TOPUnpackerModule()

TOPUnpackerModule

(

)

Constructor.

Definition at line 51 of file TOPUnpackerModule.cc.

                                       : Module()
  {
    // set module description
    setDescription("Raw data unpacker for TOP");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // Add parameters
    addParam("inputRawDataName", m_inputRawDataName,
             "name of RawTOP store array", string(""));
    addParam("outputDigitsName", m_outputDigitsName,
             "name of TOPDigit store array", string(""));
    addParam("outputWaveformsName", m_outputWaveformsName,
             "name of TOP(Raw/Production)Waveform store array", string(""));
    addParam("outputRawDigitsName", m_outputRawDigitsName,
             "name of TOPRawDigit store array", string(""));
    addParam("outputTemplateFitResultName", m_templateFitResultName,
             "name of TOPTemplateFitResult", string(""));
    addParam("swapBytes", m_swapBytes, "if true, swap bytes", false);
    addParam("dataFormat", m_dataFormat,
             "data format as defined in top/include/RawDataTypes.h, 0 = auto detect", 0);
    addParam("addRelations", m_addRelations,
             "if true, make relations to TOPProductionHitDebugs (production debug data format only)", true);
    addParam("errorSuppressFactor", m_errorSuppressFactor,
             "error messages suppression factor (0 = no suppression)", (unsigned) 1000);
 
  }

TOPValidationCollectorModule()

TOPValidationCollectorModule

(

)

Constructor.

Definition at line 48 of file TOPValidationCollectorModule.cc.

  {
    // set module description and processing properties
    setDescription("A collector for automatic validation of TOP calibration");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    // module parameters
    addParam("numBins", m_numBins, "number of bins of the search region", 100);
    addParam("timeRange", m_timeRange,
             "time range in which to search for the minimum [ns]", 10.0);
    addParam("sigmaSmear", m_sigmaSmear,
             "sigma in [ns] for additional smearing of PDF", 0.0);
    addParam("sample", m_sample,
             "sample type: one of dimuon or bhabha", std::string("dimuon"));
    addParam("deltaEcms", m_deltaEcms,
             "c.m.s energy window (half size) if sample is dimuon or bhabha", 0.1);
    addParam("dr", m_dr, "cut on POCA in r", 2.0);
    addParam("dz", m_dz, "cut on POCA in abs(z)", 4.0);
    addParam("minZ", m_minZ,
             "minimal local z of extrapolated hit", -130.0);
    addParam("maxZ", m_maxZ,
             "maximal local z of extrapolated hit", 130.0);
    addParam("pdfOption", m_pdfOption,
             "PDF option, one of 'rough', 'fine', 'optimal'", std::string("rough"));
 
  }

TOPWaveformFeatureExtractorModule()

TOPWaveformFeatureExtractorModule

(

)

Constructor.

Definition at line 44 of file TOPWaveformFeatureExtractorModule.cc.

                                                                       : Module()
 
  {
    // set module description (e.g. insert text)
    setDescription("Module adds raw digits that are found in waveforms "
                   "but not already present in TOPRawDigits. "
                   "Only waveforms related to TOPRawDigits are used.");
    setPropertyFlags(c_ParallelProcessingCertified);
 
    addParam("inputRawDigitsName", m_inputRawDigitsName,
             "name of TOPRawDigit store array", string(""));
    addParam("threshold", m_threshold,
             "pulse height threshold [ADC counts]", 40);
    addParam("hysteresis", m_hysteresis,
             "threshold hysteresis [ADC counts]", 10);
    addParam("thresholdCount", m_thresholdCount,
             "minimal number of samples above threshold", 3);
    addParam("setIntegral", m_setIntegral,
             "calculate and set integral for online-extracted hits", true);
 
  }

TOPWaveformQualityPlotterModule()

TOPWaveformQualityPlotterModule

(

)

Constructor.

Definition at line 39 of file TOPWaveformQualityPlotterModule.cc.

    : HistoModule()
  {
    setDescription("TOP DQM histogram module");
    addParam("histogramDirectoryName", m_histogramDirectoryName,
             "histogram directory in ROOT file", string("TOP"));
    addParam("drawWaves", m_DRAWWAVES, "option to draw waveforms", true);
    addParam("debugHistos", m_DEBUGGING, "option to draw debug histograms", true);
    addParam("noisemaps", m_NOISE, "option to draw noisemaps", false);
  }

unpackHeadersInterimFEVer01()

bool unpackHeadersInterimFEVer01 ( const int *  buffer, int  bufferSize, bool  swapBytes  )

private

Tries to unpack raw data assuming it is in feature-extraction interim format.

Does not write out anything, just checks integrity.

Parameters

buffer	raw data buffer
bufferSize	buffer size
swapBytes	if true, swap bytes in buffer

Returns

true if buffer resembles interim format, false if not.

Definition at line 345 of file TOPUnpackerModule.cc.

  {
    B2DEBUG(22, "Checking whether buffer unpacks as InterimFEVer01, dataSize = " << bufferSize);
 
    DataArray array(buffer, bufferSize, swapBytes);
 
    array.getWord(); // header word 0
    array.getWord(); // header word 1 (what it contains?)
    while (array.getRemainingWords() > 0) {
      unsigned header = array.getWord(); // word 0
      if ((header & 0xFF) == 0xBE) { //this is a super short FE header
        continue;
      }
 
      if (header != 0xaaaa0104 and header != 0xaaaa0103 and header != 0xaaaa0100) {//cannot be interim firmware
        return false; //abort
      }
 
 
      array.getWord(); // word 1
      array.getWord(); // word 2
 
      if (header != 0xaaaa0104) {
        // feature-extracted data (positive signal)
        array.getWord(); // word 3
        array.getWord(); // word 4
        array.getWord(); // word 5
        array.getWord(); // word 6
        array.getWord(); // word 7
        array.getWord(); // word 8
        array.getWord(); // word 9
        array.getWord(); // word 10
        array.getWord(); // word 11
        array.getWord(); // word 12
        array.getWord(); // word 13
        array.getWord(); // word 14
      }
 
      unsigned magicWord = array.getWord(); // word 15
      if (magicWord != 0x7473616c) {//invalid magic word
        return false; //abort
      }
 
      if (header != 0xaaaa0103) continue;
      array.getWord(); // word 16
 
      array.getWord(); // word 17
      array.getWord(); // word 18
      array.getWord(); // word 19
 
      array.getWord(); // word 20
 
      array.getWord(); // word 21
 
      array.getWord(); // word 22
 
      int numWords = 4 * 32; // (numPoints + 1) / 2;
      if (array.getRemainingWords() < numWords) { //not enough remaining words for waveform data
        return false; //abort
      }
 
      for (int i = 0; i < numWords; i++) {
        array.getWord();
      }
    }
 
    return true;
  }

unpackInterimFEVer01()

int unpackInterimFEVer01 ( const int *  buffer, int  bufferSize, bool  pedestalSubtracted  )

private

Unpack raw data given in feature-extraction interim format.

Parameters

buffer	raw data buffer
bufferSize	buffer size
pedestalSubtracted	false for version 2, true for version 3

Returns

number of words remaining in data buffer

Definition at line 415 of file TOPUnpackerModule.cc.

  {
 
    B2DEBUG(22, "Unpacking InterimFEVer01 to TOPRawDigits and TOPRawWaveforms, "
            "dataSize = " << bufferSize);
 
    int moduleID = 0;
    int boardstack = 0;
 
    DataArray array(buffer, bufferSize, m_swapBytes);
 
    map<unsigned short, int> evtNumCounter; //counts the occurence of carrier-generated event numbers.
    std::vector<unsigned short> channelCounter(128, 0); //counts occurence of carrier/asic/channel combinations
 
    unsigned word = array.getWord(); // header word 0
    unsigned short scrodID = word & 0x0FFF;
    auto* info = m_interimFEInfos.appendNew(scrodID, bufferSize);
 
    word = array.getWord(); // header word 1 (what it contains?)
 
 
    while (array.getRemainingWords() > 0) {
 
      unsigned header = array.getWord(); // word 0
 
      if ((header & 0xFF) == 0xBE) { //this is a super short FE header
//        B2DEBUG(21, "0b" << std::bitset<8>(header & 0xFF) << " " << std::bitset<8>((header>>8) & 0xFF) << " " << std::bitset<8>((header>>16) & 0xFF) << " " << std::bitset<8>((header>>24) & 0xFF));
 
        unsigned short scrodID_SSFE;
        unsigned short carrier_SSFE;
        unsigned short asic_SSFE;
        unsigned short channel_SSFE;
        unsigned short evtNum_SSFE;
 
        evtNum_SSFE = (header >> 8) & 0xFF;
        scrodID_SSFE = (header >> 16) & 0x7F;
        channel_SSFE = (header >> 24) & 0x07;
        asic_SSFE = (header >> 27) & 0x03;
        carrier_SSFE = (header >> 29) & 0x03;
 
        const auto* feemap = m_topgp->getFrontEndMapper().getMap(scrodID_SSFE);
        if (feemap) {
          moduleID = feemap->getModuleID();
          boardstack = feemap->getBoardstackNumber();
        } else {
          B2ERROR("TOPUnpacker: no front-end map available."
                  << LogVar("SCROD ID", scrodID_SSFE));
          info->setErrorFlag(TOPInterimFEInfo::c_InvalidScrodID);
        }
 
        if (scrodID_SSFE != scrodID) {
          B2ERROR("TOPUnpacker: corrupted data - "
                  << "different scrodID's in HLSB and super short FE header."
                  << LogVar("SCROD", scrodID_SSFE)
                  << LogVar("slot", moduleID)
                  << LogVar("BS", boardstack));
          B2DEBUG(21, "Different scrodID's in HLSB and FE header: " << scrodID << " " << scrodID_SSFE << " word = 0x" << std::hex << word);
          info->setErrorFlag(TOPInterimFEInfo::c_DifferentScrodIDs);
          return array.getRemainingWords();
        }
 
        B2DEBUG(21, scrodID_SSFE << "\t" << carrier_SSFE << "\t"  << asic_SSFE << "\t" << channel_SSFE << "\t" << evtNum_SSFE);
 
        int channelID = carrier_SSFE * 32 + asic_SSFE * 8 + channel_SSFE;
        channelCounter[channelID] += 1;
        evtNumCounter[evtNum_SSFE] += 1;
 
        info->incrementFEHeadersCount();
        info->incrementEmptyFEHeadersCount();
 
        continue;
      }
 
      if (header != 0xaaaa0104 and header != 0xaaaa0103 and header != 0xaaaa0100) {
        B2ERROR("TOPUnpacker: corrupted data - invalid FE header word");
        B2DEBUG(21, "Invalid FE header word: " << std::hex << header  << " 0b" << std::bitset<32>(header));
        B2DEBUG(21, "SCROD ID: " << scrodID << " " << std::hex << scrodID);
 
        info->setErrorFlag(TOPInterimFEInfo::c_InvalidFEHeader);
        return array.getRemainingWords();
      }
 
 
      word = array.getWord(); // word 1
      unsigned short scrodID_FE = word >> 25;
      unsigned short convertedAddr = (word >> 16) & 0x1FF;
      unsigned short evtNum_numWin_trigPat_FEheader = word & 0xFFFF;
      unsigned short evtNum_FEheader = evtNum_numWin_trigPat_FEheader & 0xFF;
      evtNumCounter[evtNum_FEheader] += 1;
 
      if (scrodID_FE != scrodID) {
        B2ERROR("TOPUnpacker: different scrodID's in HLSB and FE header."
                << LogVar("scrodID (HSLB)", scrodID)
                << LogVar("scrodID (FE)", scrodID_FE));
 
        info->setErrorFlag(TOPInterimFEInfo::c_DifferentScrodIDs);
        return array.getRemainingWords();
      }
 
      word = array.getWord(); // word 2
      //      unsigned lastWrAddr = word & 0x1FF;
      unsigned lastWrAddr = (word & 0x0FF) << 1;
      //unsigned short asicChannelFE = (word >> 9) & 0x07;
      unsigned short asicChannelFE = (word >> 8) & 0x07;
      unsigned short asicFE = (word >> 12) & 0x03;
      unsigned short carrierFE = (word >> 14) & 0x03;
      unsigned short channelID = carrierFE * 32 + asicFE * 8 + asicChannelFE;
      //B2DEBUG(21, "carrier asic chn " << carrierFE << " " << asicFE << " " << asicChannelFE << " " << channelID << " 0b" << std::bitset<32>(word) );
 
      B2DEBUG(21, scrodID_FE << "\t" << carrierFE << "\t" << asicFE << "\t" << asicChannelFE << "\t" << evtNum_FEheader);
 
      channelCounter[channelID] += 1;
 
      std::vector<TOPRawDigit*> digits; // needed for creating relations to waveforms
 
      if (header != 0xaaaa0104) {
        // feature-extracted data (positive signal)
        array.getWord(); // word 3
        word = array.getWord(); // word 4
        short samplePeak_p = word & 0xFFFF;
        short valuePeak_p = (word >> 16) & 0xFFFF;
 
        word = array.getWord(); // word 5
        short sampleRise_p = word & 0xFFFF;
        short valueRise0_p = (word >> 16) & 0xFFFF;
 
        word = array.getWord(); // word 6
        short valueRise1_p = word & 0xFFFF;
        short sampleFall_p = (word >> 16) & 0xFFFF;
 
        word = array.getWord(); // word 7
        short valueFall0_p = word & 0xFFFF;
        short valueFall1_p = (word >> 16) & 0xFFFF;
 
        word = array.getWord(); // word 8
        short integral_p = word & 0xFFFF;
        //      short qualityFlags_p = (word >> 16) & 0xFFFF;
 
        // feature-extracted data (negative signal)
        array.getWord(); // word 9
        //word = array.getWord(); // word 9
        //short n_samp_i = (word >> 16) & 0xFFFF;
        word = array.getWord(); // word 10
        short samplePeak_n = word & 0xFFFF;
        short valuePeak_n = (word >> 16) & 0xFFFF;
 
        array.getWord(); // word 11
        //word = array.getWord(); // word 11
        //short sampleRise_n = word & 0xFFFF;
        //short valueRise0_n = (word >> 16) & 0xFFFF;
 
        array.getWord(); // word 12
        //word = array.getWord(); // word 12
        //short valueRise1_n = word & 0xFFFF;
        //short sampleFall_n = (word >> 16) & 0xFFFF;
 
        array.getWord(); // word 13
        //word = array.getWord(); // word 13
        //short valueFall0_n = word & 0xFFFF;
        //short valueFall1_n = (word >> 16) & 0xFFFF;
 
        word = array.getWord(); // word 14
        short integral_n = word & 0xFFFF;
        short qualityFlags_n = (word >> 16) & 0xFFFF;
 
        if (abs(valuePeak_p) != 9999) {
          auto* digit = m_rawDigits.appendNew(scrodID, TOPRawDigit::c_Interim);
          digit->setCarrierNumber(carrierFE);
          digit->setASICNumber(asicFE);
          digit->setASICChannel(asicChannelFE);
          digit->setASICWindow(convertedAddr);
          digit->setLastWriteAddr(lastWrAddr);
          digit->setSampleRise(sampleRise_p);
          digit->setDeltaSamplePeak(samplePeak_p - sampleRise_p);
          digit->setDeltaSampleFall(sampleFall_p - sampleRise_p);
          digit->setValueRise0(valueRise0_p);
          digit->setValueRise1(valueRise1_p);
          digit->setValuePeak(valuePeak_p);
          digit->setValueFall0(valueFall0_p);
          digit->setValueFall1(valueFall1_p);
          digit->setIntegral(integral_p);
          //        digit->setErrorFlags(qualityFlags_p); // not good solution !
          digit->addRelationTo(info);
          digits.push_back(digit);
          //template fit result is saved in negative pulse fe data
          if (valuePeak_p < 150) {
            auto* tlpfResult = m_templateFitResults.appendNew();
            tlpfResult->setBackgroundOffset(samplePeak_n);
            tlpfResult->setAmplitude(valuePeak_n);
            tlpfResult->setChisquare(qualityFlags_n);
            tlpfResult->setRisingEdgeAndConvert(integral_n);
            digit->addRelationTo(tlpfResult);
          }
        }
        /*if (abs(valuePeak_n) != 9999) {
          auto* digit = m_rawDigits.appendNew(scrodID, TOPRawDigit::c_Interim);
          digit->setCarrierNumber(carrierFE);
          digit->setASICNumber(asicFE);
          digit->setASICChannel(asicChannelFE);
          digit->setASICWindow(convertedAddr);
          digit->setLastWriteAddr(lastWrAddr);
          digit->setSampleRise(sampleRise_n);
          digit->setDeltaSamplePeak(samplePeak_n - sampleRise_n);
          digit->setDeltaSampleFall(sampleFall_n - sampleRise_n);
          digit->setValueRise0(valueRise0_n);
          digit->setValueRise1(valueRise1_n);
          digit->setValuePeak(valuePeak_n);
          digit->setValueFall0(valueFall0_n);
          digit->setValueFall1(valueFall1_n);
          digit->setIntegral(integral_n);
          //        digit->setErrorFlags(qualityFlags_n); // not good solution !
          digit->addRelationTo(info);
          digits.push_back(digit);
        }*/
      }
 
      // magic word
      word = array.getWord(); // word 15
      if (word != 0x7473616c) {
        //B2ERROR("TOPUnpacker: corrupted data - no magic word at the end of FE header");
        //B2DEBUG(21, "No magic word at the end of FE header, found: "
        //<< std::hex << word);
        info->setErrorFlag(TOPInterimFEInfo::c_InvalidMagicWord);
        //return array.getRemainingWords(); do not abort event for now as footer is invalid in current debugging version of firmware
      }
 
      // store to raw digits
 
      info->incrementFEHeadersCount();
      if (digits.empty()) info->incrementEmptyFEHeadersCount();
 
      if (header != 0xaaaa0103) continue;
 
      // waveform header
      word = array.getWord(); // word 16
      unsigned long evtNum_numWaves_refWin_WFheader = word;
      unsigned short evtNum_WFheader = (evtNum_numWaves_refWin_WFheader >> 24) & 0xFF;
 
      if (evtNum_WFheader != evtNum_FEheader) {
        B2ERROR("TOPUnpacker: different carrier event number in WF and FE header."
                << LogVar("Event number (FE header)", evtNum_FEheader)
                << LogVar("Event number (WF header)", evtNum_WFheader));
      }
 
      array.getWord(); // word 17
      array.getWord(); // word 18
      word = array.getWord(); // word 19
      // int numPoints = (word >> 16) & 0xFFFF;
      unsigned short carrier = (word >> 14) & 0x03;
      unsigned short asic = (word >> 12) & 0x03;
      unsigned short asicChannel = (word >> 9) & 0x07;
      unsigned short window = word & 0x1FF;
 
      // checks for data corruption
      if (carrier != carrierFE) {
        B2ERROR("TOPUnpacker: different carrier numbers in FE and WF header");
        B2DEBUG(21, "Different carrier numbers in FE and WF header: "
                << carrierFE << " " << carrier);
        info->setErrorFlag(TOPInterimFEInfo::c_DifferentCarriers);
      }
      if (asic != asicFE) {
        B2ERROR("TOPUnpacker: different ASIC numbers in FE and WF header");
        B2DEBUG(21, "Different ASIC numbers in FE and WF header: "
                << asicFE << " " << asic);
        info->setErrorFlag(TOPInterimFEInfo::c_DifferentAsics);
      }
      if (asicChannel != asicChannelFE) {
        B2ERROR("TOPUnpacker: different ASIC channel numbers in FE and WF header");
        B2DEBUG(21, "Different ASIC channel numbers in FE and WF header: "
                << asicChannelFE << " " << asicChannel);
        info->setErrorFlag(TOPInterimFEInfo::c_DifferentChannels);
      }
      if (window != convertedAddr) {
        B2ERROR("TOPUnpacker: different window numbers in FE and WF header");
        B2DEBUG(21, "Different window numbers in FE and WF header: "
                << convertedAddr << " " << window);
        info->setErrorFlag(TOPInterimFEInfo::c_DifferentWindows);
      }
 
      // reading out all four window addresses
      // to be for correcnt alignment of individual readout windows in written waveform
      std::vector<unsigned short> windows;
      windows.push_back(window);
 
      word = array.getWord(); // word 20
      windows.push_back(word & 0x1FF);
 
      word = array.getWord(); // word 21
      windows.push_back(word & 0x1FF);
 
      word = array.getWord(); // word 22
      windows.push_back(word & 0x1FF);
 
      int numWords = 4 * 32; // (numPoints + 1) / 2;
      if (array.getRemainingWords() < numWords) {
        B2ERROR("TOPUnpacker: too few words for waveform data."
                << LogVar("needed", numWords)
                << LogVar("available", array.getRemainingWords()));
        info->setErrorFlag(TOPInterimFEInfo::c_InsufficientWFData);
        return array.getRemainingWords();
      }
 
      // unpack waveforms
      std::vector<short> adcData;
      for (int i = 0; i < numWords; i++) {
        word = array.getWord();
        adcData.push_back(word & 0xFFFF);
        adcData.push_back((word >> 16) & 0xFFFF);
      }
      // if (numWords * 2 != numPoints) adcData.pop_back(); // numPoints is even
 
      // determine slot number (moduleID) and boardstack
      moduleID = 0;
      boardstack = 0;
      const auto* feemap = m_topgp->getFrontEndMapper().getMap(scrodID);
      if (feemap) {
        moduleID = feemap->getModuleID();
        boardstack = feemap->getBoardstackNumber();
      } else {
        B2ERROR("TOPUnpacker: no front-end map available."
                << LogVar("SCROD ID", scrodID));
        info->setErrorFlag(TOPInterimFEInfo::c_InvalidScrodID);
      }
 
      // determine hardware channel and pixelID (valid only if feemap available!)
      const auto& mapper = m_topgp->getChannelMapper();
      unsigned channel = mapper.getChannel(boardstack, carrier, asic, asicChannel);
      int pixelID = mapper.getPixelID(channel);
 
      // store to raw waveforms
      auto* waveform = m_waveforms.appendNew(moduleID, pixelID, channel, scrodID,
                                             window, 0, adcData);
      waveform->setLastWriteAddr(lastWrAddr);
      waveform->setStorageWindows(windows);
      waveform->setPedestalSubtractedFlag(pedestalSubtracted);
      waveform->addRelationTo(info);
      info->incrementWaveformsCount();
 
      // create relations btw. raw digits and waveform
      for (auto& digit : digits) digit->addRelationTo(waveform);
 
    }
 
    if (evtNumCounter.size() != 1) {
      B2ERROR("TOPUnpacker: Possible frame shift detected "
              << "(More than one unique carrier event number in this readout event)."
              << LogVar("SCROD", scrodID)
              << LogVar("slot", moduleID)
              << LogVar("BS", boardstack));
    }
 
    int nASICs = 0;
 
    string evtNumOutputString;
    evtNumOutputString += "Carrier event numbers and their counts for SCROD ID " + std::to_string(scrodID) + ":\n";
    for (auto const& it : evtNumCounter) {
      nASICs += it.second;
      evtNumOutputString += std::to_string(it.first) + ":\t" + std::to_string(it.second) + "\n";
    }
    evtNumOutputString += "Total:\t" + std::to_string(nASICs);
    B2DEBUG(21, evtNumOutputString);
 
    int nChannels = 0;
    int nChannelsDiff = 0;
 
    string channelOutputString;
    channelOutputString += "Detected channels and their counts for SCROD ID (channels with count == 1 are omitted)" + std::to_string(
                             scrodID) + ":\n";
 
    int channelIndex(0);
    for (auto const& it : channelCounter) {
      if (it > 0) {
        nChannelsDiff += 1;
      }
      nChannels += it;
 
      int channelID = channelIndex;
      int carrier = channelID / 32;
      int asic = (channelID % 32) / 8;
      int chn = channelID % 8;
 
      if (it != 1) {
        channelOutputString += "carrier: " + std::to_string(carrier) + " asic: " + std::to_string(asic) + " chn: " + std::to_string(
                                 chn) + " occurence: " + std::to_string(it) + "\n";
        B2WARNING("TOPUnpacker: interim FE - ASIC channel seen more than once"
                  << LogVar("ScrodID", scrodID)
                  << LogVar("carrier", carrier)
                  << LogVar("ASIC", asic)
                  << LogVar("channel", chn)
                  << LogVar("times seen", it));
      }
      channelIndex += 1;
    }
 
    m_channelStatistics[nChannels] += 1;
 
    channelOutputString += "Total:\t" + std::to_string(nChannels) + " " + std::to_string(nChannelsDiff);
    B2DEBUG(21, channelOutputString);
 
    return array.getRemainingWords();
 
 
  }

unpackProdDebug()

int unpackProdDebug ( const int *  buffer, int  bufferSize, TOP::RawDataType  dataFormat, bool  pedestalSubtracted  )

private

Unpack raw data given in production debugging format.

Parameters

buffer	raw data buffer
bufferSize	buffer size
dataFormat	data format
pedestalSubtracted	true, if pedestal is subtracted in waveforms

Returns

number of words remaining in data buffer

Definition at line 821 of file TOPUnpackerModule.cc.

  {
 
    B2DEBUG(22, "Unpacking Production firmware debug data format to TOPRawDigits "
            "dataSize = " << bufferSize);
 
    DataArray array(buffer, bufferSize, m_swapBytes);
    unsigned word;
 
    word = array.getWord(); // word 0, type(8)/version(8)/0xA(4)/ScrodID(12)
    unsigned int evtType = word >> 24;
    unsigned int evtVersion = (word >> 16) & 0xFF;
    unsigned int evtMagicHeader = (word >> 12) & 0xF;
    unsigned int evtScrodID = word & 0xFFF;
 
    // determine slot number (moduleID) and boardstack
    int moduleID = 0;
    int boardstack = 0;
    const auto* feemap = m_topgp->getFrontEndMapper().getMap(evtScrodID);
    if (feemap) {
      moduleID = feemap->getModuleID();
      boardstack = feemap->getBoardstackNumber();
    } else {
      B2WARNING("TOPUnpacker: no front-end map available."
                << LogVar("SCROD ID", evtScrodID));
    }
 
 
    B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
            (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
            << "\tevtType = " << evtType
            << ", evtVersion = " << evtVersion
            << ", evtMagicHeader = " << evtMagicHeader
            << ", evtScrodID = " << evtScrodID);
 
    if (evtMagicHeader != 0xA) {
      B2WARNING("TOPUnpacker: event header magic word mismatch. should be 0xA."
                << LogVar("Magic word", evtMagicHeader));
      return array.getRemainingWords();
    }
 
    word = array.getWord(); // word 1, extra(3)/numWordsBonus(13)/phase(4)/numWordsCore(12)
    unsigned int evtExtra = word >> 29;
    unsigned int evtNumWordsBonus = (word >> 16) & 0x1FFF;
    unsigned int evtPhase = (word >> 12) & 0xF;
    unsigned int evtNumWordsCore = word & 0xFFF;
 
    B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
            (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
            << "\tevtExtra = " << evtExtra
            << ", evtNumWordsBonus = " << evtNumWordsBonus
            << ", evtPhase = " << evtPhase
            << ", numWordsCore = " << evtNumWordsCore);
 
    word = array.getWord(); // word 2, skipHit(1)/reserved(4)/ctime LSBs(11)/revo9counter(16)
    bool         evtSkipHit = word >> 29;
    unsigned int evtCtime = (word >> 16) & 0x7FF;
    unsigned int evtRevo9Counter = word & 0xFFFF;
 
    B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
            (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
            << "\tevtSkipHit = " << evtSkipHit
            << ", evtCtime = " << evtCtime
            << ", evtRevo9Counter = " << evtRevo9Counter);
 
    word = array.getWord(); // word 3, asicMask(16)/eventQueueDepth(8)/eventNumberByte(8)
    unsigned int evtAsicMask = word >> 16;
    unsigned int evtEventQueueDepth = (word >> 8) & 0xFF;
    unsigned int evtEventNumberByte = word & 0xFF;
 
    B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
            (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
            << "\tevtAsicMask = " << evtAsicMask
            << ", evtEventQueueDepth = " << evtEventQueueDepth
            << ", evtEventNumberByte = " << evtEventNumberByte);
 
    m_productionEventDebugs.appendNew(evtType,
                                      evtVersion,
                                      evtScrodID,
                                      evtSkipHit,
                                      evtCtime,
                                      evtPhase,
                                      evtAsicMask,
                                      evtEventQueueDepth,
                                      evtEventNumberByte);
 
    B2DEBUG(22, "end of event header, start of hits:");
 
    const int numWordsPerHit = 4 + evtExtra;
    unsigned int numHitsFound = 0;
    unsigned int numExpectedWaveforms = 0;
 
    std::vector<TOPRawDigit*> digitsWithWaveform;  // digits that have waveforms
 
    while (array.getRemainingWords() > numWordsPerHit //one more full hit + one word of footer
           && array.getIndex() < evtNumWordsCore - 2) {  // -1 for 0-based counting, -1 for hit footer word
      array.resetChecksum();
 
 
      //need to predefine some variables here as we need to branch out between two data format versions for the next two words
      unsigned int hitCarrier = 0;
      unsigned int hitAsic = 0;
      unsigned int hitChannel = 0;
      unsigned int hitWindow = 0;
      unsigned int hitMagicHeader = 0;
      unsigned int hitTFine = 0;
      bool         hitHasWaveform = false;
      bool         hitIsOnHeap = false;
      unsigned int hitHeapWindow = 0;
      bool         hitIsOnHeapStraddle = false;
      unsigned int hitHeapWindowStraddle = 0;
      bool         hitIsWindowStraddle = false;
      short        hitIntegral = 0;
      short        hitVPeak = 0;
 
      if (dataFormat == TOP::RawDataType::c_ProductionDebug01) {    //dataformat 0x0401
        word = array.getWord(); // hit word 0, carrier(2)/asic(2)/channel(3)/window(9)/0xB(4)/tFine(4)/hasWaveform(1)/isOnHeap(1)/heapWindow(6)
        hitCarrier = word >> 30;
        hitAsic = (word >> 28) & 0x3;
        hitChannel = (word >> 25) & 0x7;
        hitWindow = (word >> 16) & 0x1FF;
        hitMagicHeader = (word >> 12) & 0xF;
        hitTFine = (word >> 8) & 0xF;
        hitHasWaveform = (word >> 7) & 0x1;
        hitIsOnHeap = (word >> 6) & 0x1;
        hitHeapWindow = word  & 0x3F;
 
 
        B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
                (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
                << "\thitCarrier = " << hitCarrier
                << ", hitAsic = " << hitAsic
                << ", hitChannel = " << hitChannel
                << ", hitWindow = " << hitWindow
                //      << ", hitMagicHeader = " << hitMagicHeader
                //      << ", hitTFine = " << hitTFine
                << ", hitHasWaveform = " << hitHasWaveform
                //      << ", hitIsOnHeap = " << hitIsOnHeap
                //      << ", hitHeapWindow = " << hitHeapWindow
               );
 
 
        word = array.getWord(); // hit word 1, reserved(3)/vPeak(13)/integral(16)
        hitVPeak = expand13to16bits(word >> 16);
        hitIntegral = word & 0xFFFF;
        B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
                (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
                << "\thitVPeak = " << hitVPeak
                << ", hitIntegral = " << hitIntegral);
 
      } else if (dataFormat == TOP::RawDataType::c_ProductionDebug02) { //dataformat 0x0402
        word = array.getWord(); // hit word 0, carrier(2)/asic(2)/channel(3)/window(9)/0xB(4)/tFine(4)/hasWaveform(1)/isWindowStraddle(1)/integral(6)
        hitCarrier = word >> 30;
        hitAsic = (word >> 28) & 0x3;
        hitChannel = (word >> 25) & 0x7;
        hitWindow = (word >> 16) & 0x1FF;
        hitMagicHeader = (word >> 12) & 0xF;
        hitTFine = (word >> 8) & 0xF;
        hitHasWaveform = (word >> 7) & 0x1;
        hitIsWindowStraddle = (word >> 6) & 0x1;
        hitIntegral = word & 0x3F;
 
 
        B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
                (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
                << "\thitCarrier = " << hitCarrier
                << ", hitAsic = " << hitAsic
                << ", hitChannel = " << hitChannel
                << ", hitWindow = " << hitWindow
                //      << ", hitMagicHeader = " << hitMagicHeader
                //      << ", hitTFine = " << hitTFine
                << ", hitHasWaveform = " << hitHasWaveform
                << ", hitIsWindowStraddle = " << hitHasWaveform
                << ", hitIntegral = " << hitIntegral
                //      << ", hitHeapWindow = " << hitHeapWindow
               );
 
        word = array.getWord(); // hit word 1, reserved(3)/vPeak(13)/isOnHeap1(1)/heapWindow1(7)/isOnHeap0(1)/heapWindow0(7)
        hitVPeak = expand13to16bits(word >> 16);
        hitIsOnHeapStraddle = (word >> 15) & 0x1;
        hitHeapWindowStraddle = (word >> 8) & 0x7F;
        hitIsOnHeap = (word >> 7) & 0x1;
        hitHeapWindow = word & 0x1;
 
        B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
                (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
                << "\thitVPeak = " << hitVPeak
                << ", hitIsOnHeapStraddle = " << hitIsOnHeapStraddle
                << ", hitHeapWindowStraddle = " << hitHeapWindowStraddle
                << ", hitIsOnHeap = " << hitIsOnHeap
                << ", hitHeapWindow = " << hitHeapWindow);
      } else { //could not match the data format
        B2WARNING("TOPUnpacker: could not match data type inside unpackProdDebug()"
                  << LogVar("evtType", evtType) << LogVar("evtVersion", evtVersion));
        return array.getRemainingWords();
      }
 
 
      if (hitHasWaveform) {
        numExpectedWaveforms += 1;
      }
 
      if (hitMagicHeader != 0xB) {
        B2WARNING("TOPUnpacker: hit header magic word mismatch. should be 0xB."
                  << LogVar("Magic word", hitMagicHeader));
        return array.getRemainingWords();
      }
 
      word = array.getWord(); // hit word 2, reserved(3)/vRise0(13)/reserved(3)/vRise1(13)
      short hitVRise0 = expand13to16bits(word >> 16);
      short hitVRise1 = expand13to16bits(word);
      B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
              (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
              << "\thitVRise0 = " << hitVRise0
              << ", hitVRise1 = " << hitVRise1);
 
      word = array.getWord(); // hit word 3, reserved(3)/vFall0(13)/reserved(3)/vFall1(13)
      short hitVFall0 = expand13to16bits(word >> 16);
      short hitVFall1 = expand13to16bits(word);
      B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
              (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
              << "\thitVFall0 = " << hitVFall0
              << ", hitVFall1 = " << hitVFall1);
 
      word = array.getWord(); // hit word 4, sampleRise(8)/dSampPeak(4)/dSampFall(4)/headerChecksum(16)
      unsigned short hitSampleRise = (word >> 24);
      short hitDSampPeak = (word >> 20) & 0xF;
      short hitDSampFall = (word >> 16) & 0xF;
      unsigned short hitHeaderChecksum = word & 0xFFFF;
      B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
              (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
              << "\thitSampleRise = " << hitSampleRise
              << ", hitDSampPeak = " << hitDSampPeak
              << ", hitDSampFall = " << hitDSampFall
              << ", hitheaderChecksum = " << hitHeaderChecksum
              << ", checksum " << (array.validateChecksum() ? "OK" : "NOT OK"));
 
      if (!array.validateChecksum()) {
        B2WARNING("TOPUnpacker: hit checksum invalid.");
        return array.getRemainingWords();
      }
 
      // append digit
      auto* digit = m_rawDigits.appendNew(evtScrodID, TOPRawDigit::c_ProductionDebug);
      digit->setCarrierNumber(hitCarrier);
      digit->setASICNumber(hitAsic);
      digit->setASICChannel(hitChannel);
      digit->setASICWindow(hitWindow);
      digit->setLastWriteAddr(0);
      digit->setSampleRise(hitSampleRise);
      digit->setDeltaSamplePeak(hitDSampPeak);
      digit->setDeltaSampleFall(hitDSampFall);
      digit->setValueRise0(hitVRise0);
      digit->setValueRise1(hitVRise1);
      digit->setValuePeak(hitVPeak);
      digit->setValueFall0(hitVFall0);
      digit->setValueFall1(hitVFall1);
      digit->setTFine(hitTFine);
      digit->setIntegral(hitIntegral);
      digit->setRevo9Counter(evtRevo9Counter);
      digit->setPhase(evtPhase);
 
 
      if (hitHasWaveform) {
        digitsWithWaveform.push_back(digit);
      }
 
      TOPProductionHitDebug* hitDebug = 0;
      if (dataFormat == TOP::RawDataType::c_ProductionDebug01) { // dataformat 0x0401
        hitDebug = m_productionHitDebugs.appendNew(hitHasWaveform,
                                                   hitIsOnHeap,
                                                   hitWindow,
                                                   hitIsOnHeap ? 428 + hitHeapWindow : hitWindow, //hitHeapWindow is counted from the start of the heap
                                                   hitIsWindowStraddle);
      } else if (dataFormat == TOP::RawDataType::c_ProductionDebug02) { // dataformat 0x0402
        hitDebug = m_productionHitDebugs.appendNew(hitHasWaveform,
                                                   hitIsOnHeap,
                                                   hitWindow,
                                                   hitIsOnHeap ? 428 + hitHeapWindow : hitWindow, //hitHeapWindow is counted from the start of the heap
                                                   hitIsWindowStraddle,
                                                   hitWindow + 1, //logical address of straddle window is always +1
                                                   hitIsOnHeapStraddle ? 428 + hitHeapWindowStraddle : hitWindow +
                                                   1); //physical address might be entirely different if straddled window is on heap
      }
 
      //parse extra words if exist:
      for (unsigned int i = 0; i < evtExtra; ++i) {
        word = array.getWord(); // extra hit word i, undefined so far
        B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
                (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
                << "\thit extra word " << i << " (" << evtExtra << ")");
        hitDebug->appendExtraWord(word);
      }
 
      if (m_addRelations and hitDebug) {
        digit->addRelationTo(hitDebug);
      }
 
      numHitsFound += 1;
    } // end of hits loop
 
    word = array.getWord(); // event footer word, sdType(8)/sdData(12)/0x5(3)/nHits(9)
    unsigned int evtSdType = (word >> 24);
    unsigned int evtSdData = (word >> 12) & 0xFFF;
    unsigned int evtMagicFooter = (word >> 9) & 0x7;
    unsigned int evtNHits = word & 0x1FF;
    B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
            (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
            << "\tevtSdType = " << evtSdType
            << ", evtSdData = " << evtSdData
            << ", evtMagicFooter = " << evtMagicFooter
            << ", evtNHits = " << evtNHits << " (" << numHitsFound << ")");
 
    if (evtSdType != 0) {
      m_slowData.appendNew(evtScrodID, evtSdType, evtSdData);
    }
 
    if (evtMagicFooter != 0x5) {
      B2WARNING("TOPUnpacker: event footer magic word mismatch. should be 0x5."
                << LogVar("Magic word", evtMagicFooter));
      return array.getRemainingWords();
    }
 
    B2DEBUG(22, "the rest:");
 
    unsigned int numParsedWaveforms = 0;
    while (array.peekWord() != 0x6c617374 //next word is not wf footer word
           && array.getRemainingWords() > 0) {
 
      word = array.getWord(); // waveform word 0, nSamples(16)/0x0(5)/nWindows(3)/0(1)/carrier(2)/asic(2)/channel(3)
      unsigned int wfNSamples = (word >> 16);
      unsigned int wfNWindows = (word >> 8) & 0x7;
      unsigned int wfCarrier = (word >> 5) & 0x3;
      unsigned int wfAsic = (word >> 3) & 0x3;
      unsigned int wfChannel = word & 0x7;
 
      // determine hardware channel and pixelID (valid only if feemap available!)
      const auto& mapper = m_topgp->getChannelMapper();
      unsigned channel = mapper.getChannel(boardstack, wfCarrier, wfAsic, wfChannel);
      int pixelID = mapper.getPixelID(channel);
 
      B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
              (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
              << "\twfNSamples = " << wfNSamples
              << ", wfNWindows = " << wfNWindows
              << ", wfCarrier = " << wfCarrier
              << ", wfAsic = " << wfAsic
              << ", wfChannel " << wfChannel);
 
      if (wfNSamples != 32 && wfNSamples != 16) {
        B2WARNING("TOPUnpacker: suspicious value for wfNSamples."
                  << LogVar("wfNSamples", wfNSamples));
        return array.getRemainingWords();
      }
 
      word = array.getWord(); // waveform word 1, 0x0(1)/startSamp(6)/logAddress(9)/carrierEventNumber(7)/readAddr(9)
      unsigned int wfStartSample = (word >> 25) & 0x3F;
      unsigned int wfWindowLogic = (word >> 16) & 0x1FF;
      unsigned int wfEventNumber = (word >> 9) & 0x7F;
      unsigned int wfWindowPhysical = word & 0x1FF;
 
      B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
              (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
              << "\twfStartSample = " << wfStartSample
              << ", wfWindowLogic = " << wfWindowLogic
              << ", wfEventNumber = " << wfEventNumber
              << ", wfWindowPhysical = " << wfWindowPhysical);
 
      std::vector<short> wfSamples;
 
      for (unsigned int i = 0; i < wfNSamples / 2; ++i) {
        short wfSampleLast = 0;
        short wfSampleFirst = 0;
 
 
        word = array.getWord(); // waveform sample word i, reserved(4)/sample 2*i+1(12)/reserved(4)/sample 2*i(12)
        if (pedestalSubtracted) {
          wfSampleLast = (word >> 16);
          wfSampleFirst = word & 0xFFFF;
        } else {
          wfSampleLast = (word >> 16) & 0xFFF;
          wfSampleFirst = word & 0xFFF;
 
        }
 
        B2DEBUG(22, std::dec << array.getIndex() << ":\t" << setfill('0') << setw(4) << std::hex <<
                (word >> 16) << " " << setfill('0') << setw(4) << (word & 0xFFFF) << std::dec
                << "\twfSample" << 2 * i + 1 << " = " << wfSampleLast
                << ", wfSample" << 2 * i << " = " << wfSampleFirst);
 
        wfSamples.push_back(wfSampleFirst);
        wfSamples.push_back(wfSampleLast);
      }
 
      // append waveform
      auto* waveform = m_waveforms.appendNew(moduleID, pixelID, channel, evtScrodID,
                                             wfWindowLogic, wfStartSample, wfSamples);
      waveform->setPedestalSubtractedFlag(pedestalSubtracted);
      waveform->setPhysicalWindow(wfWindowPhysical);
      if (numParsedWaveforms < digitsWithWaveform.size()) {
        const auto* digit = digitsWithWaveform[numParsedWaveforms];
        if (digit->getScrodChannel() == channel % 128) {
          digit->addRelationTo(waveform);
        } else {
          B2WARNING("TOPUnpacker: hit and its waveform have different channel number."
                    << LogVar("channel (hit)", digit->getScrodChannel())
                    << LogVar("channel (waveform)", channel % 128));
        }
      }
      numParsedWaveforms += 1;
 
    } // end of waveform segments loop
 
    if (numExpectedWaveforms != numParsedWaveforms) {
      B2WARNING("TOPUnpacker: number of expected and parsed waveforms does not match."
                << LogVar("expected", numExpectedWaveforms)
                << LogVar("parsed", numParsedWaveforms));
    }
 
    return array.getRemainingWords();
  }

unpackProductionDraft()

void unpackProductionDraft ( const int *  buffer, int  bufferSize  )

private

Unpack raw data given in a tentative production format (will vanish in future)

Parameters

buffer	raw data buffer
bufferSize	buffer size

Definition at line 243 of file TOPUnpackerModule.cc.

  {
 
    B2DEBUG(22, "Unpacking ProductionDraft to TOPDigits, dataSize = " << bufferSize);
 
    unsigned short scrodID = buffer[0] & 0xFFFF;
    const auto* feemap = m_topgp->getFrontEndMapper().getMap(scrodID);
    if (!feemap) {
      B2ERROR("TOPUnpacker: no front-end map available."
              << LogVar("SCROD ID", scrodID));
      return;
    }
    int moduleID = feemap->getModuleID();
    int boardstack = feemap->getBoardstackNumber();
    const auto& mapper = m_topgp->getChannelMapper();
 
    const auto* geo = m_topgp->getGeometry();
    auto subBits = geo->getNominalTDC().getSubBits();
    int sampleDivisions = 0x1 << subBits;
 
    for (int i = 1; i < bufferSize; i++) {
      int word = buffer[i];
      int tdc = word & 0xFFFF;
      double rawTime = double(tdc) / sampleDivisions;
      unsigned chan = ((word >> 16) & 0x7F) + boardstack * 128;
      unsigned flags = (word >> 24) & 0xFF;
      int pixelID = mapper.getPixelID(chan);
      auto* digit = m_digits.appendNew(moduleID, pixelID, rawTime);
      digit->setTime(geo->getNominalTDC().getTime(tdc));
      digit->setChannel(chan);
      digit->setHitQuality((TOPDigit::EHitQuality) flags);
    }
 
  }

unpackType0Ver16()

void unpackType0Ver16 ( const int *  buffer, int  bufferSize  )

private

Unpack raw data given in feature-extraction production format.

Parameters

buffer	raw data buffer
bufferSize	buffer size

Definition at line 279 of file TOPUnpackerModule.cc.

  {
 
    B2DEBUG(22, "Unpacking Type0Ver16 to TOPRawDigits, dataSize = " << bufferSize);
 
    DataArray array(buffer, bufferSize, m_swapBytes);
    unsigned word = array.getWord();
    unsigned short scrodID = word & 0x0FFF;
 
    unsigned last = array.getLastWord();
    int Nhits = last & 0x01FF;
    if (bufferSize != 5 * Nhits + 2) {
      B2ERROR("TOPUnpacker: corrupted data (feature-extraction format)."
              << LogVar("SCROD ID", scrodID));
      return;
    }
 
    short SDType = last >> 24;
    short SDValue = (last >> 12) & 0x0FFF;
    if (SDType != 0) m_slowData.appendNew(scrodID, SDType, SDValue);
 
    unsigned short errorFlags = 0;
    if (((word >> 12) & 0x0F) != 0x0A) errorFlags |= TOPRawDigit::c_HeadMagic;
    if (((last >> 9) & 0x07) != 0x05) errorFlags |= TOPRawDigit::c_TailMagic;
 
    for (int hit = 0; hit < Nhits; hit++) {
      auto* digit = m_rawDigits.appendNew(scrodID, TOPRawDigit::c_Production);
 
      word = array.getWord(); // word 1
      digit->setCarrierNumber((word >> 30) & 0x03);
      digit->setASICNumber((word >> 28) & 0x03);
      digit->setASICChannel((word >> 25) & 0x07);
      digit->setASICWindow((word >> 16) & 0x1FF);
      digit->setTFine((word >> 8) & 0x0F);
      auto flags = errorFlags;
      if (((word >> 12) & 0x0F) != 0x0B) flags |= TOPRawDigit::c_HitMagic;
      unsigned short checkSum = sumShorts(word);
 
      word = array.getWord(); // word 2
      digit->setValuePeak(expand13to16bits(word >> 16));
      digit->setIntegral(word & 0xFFFF);
      checkSum += sumShorts(word);
 
      word = array.getWord(); // word 3
      digit->setValueRise0(expand13to16bits(word >> 16));
      digit->setValueRise1(expand13to16bits(word));
      checkSum += sumShorts(word);
 
      word = array.getWord(); // word 4
      digit->setValueFall0(expand13to16bits(word >> 16));
      digit->setValueFall1(expand13to16bits(word));
      checkSum += sumShorts(word);
 
      word = array.getWord(); // word 5
      digit->setSampleRise(word >> 24);
      digit->setDeltaSamplePeak((word >> 20) & 0x0F);
      digit->setDeltaSampleFall((word >> 16) & 0x0F);
      checkSum += sumShorts(word);
      if (checkSum != 0) flags |= TOPRawDigit::c_HitChecksum;
 
      digit->setErrorFlags(flags);
 
    }
 
  }

~OpticalGunModule()

~OpticalGunModule ( )

virtual

Destructor.

Definition at line 85 of file OpticalGunModule.cc.

  {
    if (m_customDistribution) delete m_customDistribution;
  }

~TOPBackgroundModule()

~TOPBackgroundModule ( )

virtual

Destructor.

Definition at line 111 of file TOPBackgroundModule.cc.

  {
 
  }

~TOPChannelT0MCModule()

~TOPChannelT0MCModule ( )

virtual

Destructor.

Definition at line 52 of file TOPChannelT0MCModule.cc.

  {
  }

~TOPDoublePulseGeneratorModule()

~TOPDoublePulseGeneratorModule ( )

virtual

Destructor.

Definition at line 85 of file TOPDoublePulseGeneratorModule.cc.

  {
    if (m_timebase) delete m_timebase;
  }

~TOPDQMModule()

~TOPDQMModule ( )

virtual

Destructor.

Definition at line 55 of file TOPDQMModule.cc.

  {
  }

~TOPGainEfficiencyCalculatorModule()

~TOPGainEfficiencyCalculatorModule ( )

virtual

Destructor.

Definition at line 83 of file TOPGainEfficiencyCalculatorModule.cc.

{}

~TOPInterimFENtupleModule()

~TOPInterimFENtupleModule ( )

virtual

Destructor.

Definition at line 78 of file TOPInterimFENtupleModule.cc.

{}

~TOPLaserCalibratorModule()

~TOPLaserCalibratorModule ( )

virtual

Destructor.

Definition at line 71 of file TOPLaserCalibratorModule.cc.

  {
  }

~TOPLaserHitSelectorModule()

~TOPLaserHitSelectorModule ( )

virtual

Destructor.

Definition at line 92 of file TOPLaserHitSelectorModule.cc.

{}

~TOPMCTrackMakerModule()

~TOPMCTrackMakerModule ( )

virtual

Destructor.

Definition at line 57 of file TOPMCTrackMakerModule.cc.

  {
  }

~TOPNtupleModule()

~TOPNtupleModule ( )

virtual

Destructor.

Definition at line 68 of file TOPNtupleModule.cc.

  {
  }

~TOPPackerModule()

~TOPPackerModule ( )

virtual

Destructor.

Definition at line 66 of file TOPPackerModule.cc.

  {
  }

~TOPRawDigitConverterModule()

~TOPRawDigitConverterModule ( )

virtual

Destructor.

Definition at line 109 of file TOPRawDigitConverterModule.cc.

  {
  }

~TOPTimeBaseCalibratorModule()

~TOPTimeBaseCalibratorModule ( )

virtual

Destructor.

Definition at line 102 of file TOPTimeBaseCalibratorModule.cc.

  {
  }

~TOPTriggerDigitizerModule()

~TOPTriggerDigitizerModule ( )

virtual

Destructor.

Definition at line 64 of file TOPTriggerDigitizerModule.cc.

  {
  }

~TOPUnpackerModule()

~TOPUnpackerModule ( )

virtual

Destructor.

Definition at line 78 of file TOPUnpackerModule.cc.

  {
  }

~TOPWaveformFeatureExtractorModule()

~TOPWaveformFeatureExtractorModule ( )

virtual

Destructor.

Definition at line 66 of file TOPWaveformFeatureExtractorModule.cc.

  {
  }