#include <GETSystem.hh>

Inheritance diagram for GETSystem:

Public Member Functions
Constructors, affectation, destructor
	GETSystem (u_int n_cobo=1, u_int dim=0, double dt=0.01L)

virtual	~GETSystem ()

GET configuration
virtual int	ResetConfig ()

virtual int	InitConfig ()

const GETCfgSetup *	GetConfig () const

GETCfgSetup *	GetConfig ()

virtual int	ReadXMLConfig (const string &fname)

Initialization functions
virtual void	Reset ()

virtual int	Init (u_int n_cobo, u_int n, double dt)

virtual void	ClearEvent ()

u_int	GetBadReadCount () const

const GETData *	GetBadReadData () const

GETData *	GetBadReadData ()

void	SetBadDataCorrection (bool b)

bool	ChannelHasData (u_int ic) const

u_int	CalcMultiplicity (bool fpn=true)

u_int	GetChannelMultiplicity () const

u_int	GetAGetMultiplicity () const

u_int	GetAsAdMultiplicity () const

u_int	GetCoBoMultiplicity () const

GET system core objects functions
virtual string	GetObjectId () const

virtual u_int	GetChildrenNumber () const

virtual const GETObject *	GetChild (u_int i) const

virtual GETObject *	GetChild (u_int i)

const GETCoBo &	operator[] (u_int n) const

GETCoBo &	operator[] (u_int n)

virtual u_int	GetCoBoNumber () const

virtual u_int	GetAsAdNumber () const

virtual int	GetChannelIndex (const GETChannel *ch)

Look-up table and analysis tools
const GETLookupTable &	LookupTable () const

GETLookupTable &	LookupTable ()

virtual u_int	GetChannelCount () const

virtual int	GetChannelIndex (int ix, int iy) const

virtual GETChannel *	GetChannel (int ix, int iy) const

virtual GETChannel *	GetChannel (u_int n)

virtual int	GetTestChannelIndex ()

virtual GETChannel *	GetTestChannel ()

virtual GETChannel *	SetTestChannel (int i)

virtual GETHitMask *	SetHitMask (GETHitMask *mask)

GETHitMask *	GetHitMask () const

virtual int	SetAnalyser (GETSystemAnalyser *a)

GETSystemAnalyser *	GetAnalyser () const

Data correction and processes
virtual int	SetCalibProcess (const string &calib_file, u_short opt=0)

virtual int	SetBaselineCorrection (const string &bl_file)

virtual int	SetTimeCorrectionProcess (const string &shift_file)

virtual int	SetOutputSmoothing (double width)

virtual int	SetAutoBaseline (u_short num_lo, u_short num_hi, u_short off_lo=0, u_short off_hi=0)

virtual int	SetAutoBLoffset (u_short itmin, u_short itmax)

virtual int	SetResponseFunctions (const string &rf_file)

virtual int	SetAsAdResponseFunctions (const string &rf_file)

Experimental data readout
virtual int	OpenRunFile (const string &fname)

virtual int	OpenRunSerie (const string &pattern, const string &serie)

virtual int	CloseRunFile ()

void	IncrEventCount ()

u_int	GetEventCount () const

string	GetRunFileName () const

bool	IsRunFileOpen () const

GETRunFile *	GetRunFile ()

virtual int	ReadEvent ()

MFMCommonFrame *	GetCurrentMFMFrame ()

int	GetAcqEventNumber () const

uint64_t	GetAcqEventTimeStamp () const

double	GetAcqEventTimeSec () const

virtual void	SelectAnalysis (u_short sel)

virtual void	SetAnalysis (u_short sel, bool b=true)

virtual void	SetInputRecAnalysis (bool b=true)

virtual void	SetRawDataAnalysis (bool b=true)

virtual void	SetCorDataAnalysis (bool b=true)

u_short	GetAnalysisFlags () const

bool	AnalyseInputRec () const

bool	AnalyseRawData () const

bool	AnalyseCorData () const

virtual int	AnalyseEvent ()

virtual int	AnalyseRawEvent ()

virtual int	AnalyseCorEvent ()

virtual bool	AnalysingRaw () const

virtual bool	AnalysingCor () const

virtual int	ExtractXMLFileHeaderFrame ()

virtual int	ExtractCoboTopoFrame ()

virtual int	ExtractCoboFrame ()

virtual int	ExtractEbyedatFrame ()

virtual int	ExtractMergeFrame ()

virtual int	ProcessFrameData (MFMCommonFrame *frame)

virtual int	ProcessEbyedatFrameData (MFMEbyedatFrame *frame)

virtual int	ProcessMergeFrameData (MFMMergeFrame *frame)

virtual int	ProcessCoBoFrameData (MFMCoboFrame *frame)

u_int	GetCoBoFrameRead () const

u_int	GetCoBoFrameError () const

u_int	GetCoBoFrameRecover () const

virtual void	ClearCoBoDataRead ()

virtual int	CheckCoBoData (u_int cobo, u_int asad, u_int &aget, u_int &chan, u_int &buck, u_int val)

virtual u_int	CheckCoBoFrameBadChannels (int ico, int ias)

virtual u_int	CorrectCoBoFrameBadData (int ico, int ias)

Events processing and correction
virtual GETChannel *	GetMaximumChannel (u_short info=GET::signalOut, bool integ=false)

void	SetOutputData0correction (u_int n)

void	SetOutputDataNcorrection (u_int n)

u_int	GetOutputData0correction () const

u_int	GetOutputDataNcorrection () const

virtual int	OutputCorrectData0 ()

virtual int	OutputCorrectDataN ()

virtual int	OutputCorrectFPN (u_int opt_fpn=GET::CoBoCorrectFPN4)

virtual int	ZeroSuppression (double thr=0.)

User hook functions
virtual int	UserRawEvent ()

virtual int	UserCorEvent ()

virtual int	UserAnyFrame (MFMCommonFrame &frame)

virtual int	UserMergeFrame (MFMMergeFrame &frame)

virtual int	UserCoBoFrame (MFMCoboFrame &frame)

virtual int	UserEbyedatFrame (MFMEbyedatFrame &frame)

ROOT related functions
	ClassDef (GETSystem, 0)

Public Member Functions inherited from GETObject
	GETObject ()

virtual	~GETObject ()

int	GetId () const

virtual string	GetFullId () const

virtual u_int	GetSignalChannelCount () const

virtual u_int	GetTotalChannelCount () const

virtual GETChannel *	GetSignalChannel (u_int n)

virtual GETChannel *	GetTotalChannel (u_int n)

const GETObject *	GetParent () const

GETObject *	GetParent ()

virtual void	SetTimeStep (double dt)

u_int	GetSampleDim ()

double	GetTimeStep ()

virtual void	SetReadoutFlag (bool b=true)

bool	GetReadoutFlag () const

virtual u_int	GetReadoutMultiplicity (bool fpn=true) const

virtual double	GetSignalSum (u_short info=GET::signalOut)

virtual void	InitLocalData (u_int n, double dt)

virtual void	ValidDataSet ()

virtual void	ValidSimulSet ()

virtual void	SetResponse (GETResponse *ptr, bool recur=true, bool fpn=false)

virtual void	SetResponse (GETResponse &obj, bool recur=true, bool fpn=false)

virtual void	SetFilter (GETFilter *ptr, bool recur=true, bool fpn=false)

virtual void	SetFilter (GETFilter &obj, bool recur=true, bool fpn=false)

virtual void	SetNoiseIn (GETSignalModifier *ptr, bool recur=true, bool fpn=false)

virtual void	SetNoiseIn (GETSignalModifier &obj, bool recur=true, bool fpn=false)

virtual void	SetNoiseOut (GETSignalModifier *ptr, bool recur=true, bool fpn=false)

virtual void	SetNoiseOut (GETSignalModifier &obj, bool recur=true, bool fpn=false)

virtual void	SetOutputCorrection (GETProcess *ptr, bool recur=true, bool fpn=false)

virtual void	SetOutputCorrection (GETProcess &obj, bool recur=true, bool fpn=false)

virtual void	RemoveOutputCorrection ()

virtual void	SetOutputCorrectionList (bool warn=true)

virtual void	AddOutputCorrection (GETProcess *ptr, bool recur=true, bool fpn=false)

virtual void	AddOutputCorrection (GETProcess &obj, bool recur=true, bool fpn=false)

GETResponse *	GetResponse (bool force=true)

GETFilter *	GetFilter (bool force=true)

GETSignalModifier *	GetNoiseIn (bool force=true)

GETSignalModifier *	GetNoiseOut (bool force=true)

GETProcess *	GetOutputCorrection (bool force=true)

virtual int	ProcessData (bool in_noise=true)

virtual int	ProcessOutFromTst (bool in_noise=true, bool out_noise=true)

virtual int	ProcessRecFromOut (bool out_corr=true)

virtual int	ProcessOutputCorrection ()

	ClassDef (GETObject, 0)

Protected Attributes
GETSystemAnalyser *	analyser
	Pointer to a data analyser.

int	bad_cobo_channel_aget [512]
	Memorize AGET number for bad channels.

u_int	bad_cobo_channel_count
	Number for bad channels in CoBo read.

int	bad_cobo_channel_index [512]
	Memorize Channel number for bad channels.

u_int	bad_cobo_read_check
	Counter of bad data needed for missing channels in data check.

u_int	bad_cobo_read_count
	Number of bad data read.

GETData	bad_cobo_read_data [512]
	Bad data array.

u_int	bad_cobo_read_min
	Minimum number of data to keep channels in data.

u_int	bad_read_count
	Number of bad data read.

GETData	bad_read_data [512]
	Bad data array.

u_int	channel_count
	Total number of channels.

bool *	channel_hit
	Whether the channel contains data.

GETChannel **	channel_summary
	Summary of channels pointers.

GETCoBo *	cobo
	Array of CoBo modules.

int	cobo_filled [4 68 512]
	Memorization of data read in CoBo frame.

u_int	cobo_frame_error
	Number of CoBo frames with errors.

u_int	cobo_frame_read
	Total number of CoBo frames.

u_int	cobo_frame_recover
	Number of CoBo frames with errors that could be recovered.

int	cobo_last_bucket [4 *68]
	Memorization of last time bucket read / channel.

u_int	cobo_number
	Number of CoBo modules controlled.

GETCfgSetup *	config
	Configuration data.

bool	cor_data
	Whether processing corrected data.

u_int	data0_num
	Number of time buckets to set to 0 at beginning of data samples.

u_int	dataN_num
	Number of time buckets to set to 0 at end of data samples.

u_int	event_count
	Number of events read (in file)

GETHitMask *	hit_mask
	Pointer to the hit mask.

GETLookupTable	lookup_table
	Lookup table.

char *	mfm_buffer
	MFM frames data buffer.

char **	mfm_buffer_adr
	Pointer of allocated buffer.

int	mfm_buffer_size
	Size of allocated buffer.

uint64_t	mfm_event_clock
	Event clock time from MFM frames.

int	mfm_event_num
	Event number from MFM frames.

bool	mfm_event_set
	Test is event number / time stamp is set.

double	mfm_event_time
	Event time (sec) from MFM frames.

MFMCommonFrame *	mfm_frame
	Common frame for MFM in/out.

MFMCoboFrame *	mfm_frame_cobo
	Specific CoBo frame for MFM in/out.

u_int	mfm_frame_count
	Frame number in current file.

u_int	mult_aget
	Multiplicity of non empty AGet.

u_int	mult_asad
	Multiplicity of non empty AsAd.

u_int	mult_channel
	Multiplicity of non empty channels.

u_int	mult_cobo
	Multiplicity of non empty CoBo.

GETRunFile *	run_file
	Pointer to the input run data.

u_int	saturation_count
	Number of saturated channels (computed at raw event analysis)

u_int	saturation_mult
	Number of saturated data to consider a channel as saturated.

u_int	saturation_value
	Coder value for channel saturation (set to 0 not to perform the analysis)

u_short	selected_analysis
	Flag for selected analysis (see GETSystem::SelectAnalysis function)

int	test_channel
	Channel index for test outputs (-1 for none)

double	zero_threshold
	Threshold for raw data zero suppression.

Protected Attributes inherited from GETObject
GETProcessLink	filter
	Signal processing filter.

int	id
	Object identifier number (set by the parent, in filiation)

bool	is_read
	Flag indicating some data was read for the object (from exp. raw data)

GETProcessLink	noise_in
	Simulation input noise generator.

GETProcessLink	noise_out
	Simulation output noise generator.

GETProcessLink	output_corr
	Output signal correction before reconstruction of input.

GETObject *	parent
	Parent AGet chip.

GETProcessLink	response
	Signal response function.

Static Protected Attributes
static u_int	options = 0
	Options for GET system.

Private Member Functions
	GObject (GETSystem)

Friends
class	GETCfgSetup

class	GETHitMask

class	GETSystemAnalyser

Options functions
virtual void	SetZeroSuppressMode (double thr=0.)

virtual void	SetSaturationValue (int val)

virtual int	GetSaturationValue () const

virtual int	GetSaturationCount () const

virtual bool	IsChannelSaturated (u_int ich)

virtual bool	IsChannelSaturated (const GETChannel &ch)

static void	SetOptions (u_int opts)

static void	SetOption (u_int flags, bool b=true)

static u_int	GetOptions ()

static bool	GetOption (u_int flags)

Detailed Description

This class defines a the full GET system, controlling a variable number of CoBo modules.

The static options may define general behaviour of the system, such as samples corrections at readout.

The class defines some automatic corrections of raw data samples when reading an event (see options defined in the GET namespace), independently of the output data correction processes:

data-0 correction: set the first sample data to the second one (this is necessary when the first data is junk when using a reduced readout depth - seen only in full readout mode... - observed in 2018, with the 2017/02 CoBo firmware)
correction from FPN channels:
- GET::CoBoCorrectFPN for closest FPN channel correction
- GET::CoBoCorrectFPN2 for half-chip FPN channels correction
- GET::CoBoCorrectFPN4 for average (AGET chip) FPN channels correction
apply a (software) zero suppresion on raw data: this option is not compatible with the FPN correction or with the automatic baseline correction

Illustration of the event processing with GETSystem class:

Run files and run series

When reading events with the GETSystem class (with ReadEvent function), a file must have been previously opened.

A run file is either a single file, either a set of several files with the same name, but with additional prefix .1, .2... in case of automatic change of file during acquisition.
- in this case, use the GETSystem::OpenRunFile function
- the input file name may contain a * character to indicate that there can be more than 1 file (for example "run_0201.dat*")
A run serie is a list of run files, with different run numbers.
- in this case, use the GETSystem::OpenRunSerie function
- the file name must contain a R code to indicate where is the run number
- for example, OpenRunSerie ( "run_%4R.dat*", "201:203,206" ) will request to process files "run_0201.dat*", "run_0202.dat*", "run_0203.dat*" and "run_0206.dat*" (see above for the meaning of *).

Lookup table

A lookup table is associated to the GET system object in order to associate the detector channels positions to the electronics channels.

Hit mask and hit channels

A hit mask can be created (the look-up table must be defined) in order to select the channels for analysis.

The hit mask defines 2 information for each channel:

whether it is selected for analysis
whether its signal is large enough

Hit channels

It should be noted that independently of the hit mask, the GET system class defines an array of logical values that indicates whether the channels have been filled with experimental data (for example in partial readout mode).

This hit channel information is checked when applying automatic corrections to the raw data: FPN, automatic baseline, ...

Data analyser

The GETSystemAnalyser class is a base class for specific data analysis to be performed on the GETSystem data. Such an analyser can be defined with the GETSystem::SetAnalyser function.

If an anlyser is defined, its data analysis functions will be called before and after output correction when experimental data are read.

Examples:: Demonstrator_Noise.C, Demonstrator_RMS1.C, and Demonstrator_RMS2.C.

Constructor & Destructor Documentation

GETSystem::GETSystem	(	u_int	n_cobo = `1`,
		u_int	n = `0`,
		double	dt = `0.01L`
	)

Constructor.

Parameters

n_cobo	number of controlled CoBo modules
n	dimension of data samples
dt	sampling period (us)

References GET::analyseAll.

GETSystem::~GETSystem ( )

virtual

Destructor.

References analyser, channel_hit, channel_summary, CloseRunFile(), cobo, cobo_number, config, hit_mask, IsRunFileOpen(), mfm_buffer, mfm_frame, mfm_frame_cobo, and run_file.

Member Function Documentation

bool GETSystem::AnalyseCorData ( ) const

inline

Return true if corrected data analysis flag is set.

References GET::analyseCor, and selected_analysis.

Referenced by AnalyseEvent(), and GETActarEventReader::AnalysisEvent().

int GETSystem::AnalyseCorEvent ( )

virtual

Function called just after the raw data have been read and corrected according to the selected options. If a non-zero value is returned, it means an error occured and the event reading process is interrupted.

In the GETSystem base class, this function just calls the associated analyser function (if defined) .

References GETSystemAnalyser::AnalyseCorEvent(), analyser, and cor_data.

Referenced by AnalyseEvent().

int GETSystem::AnalyseEvent ( )

virtual

Function called after the raw data have been read, in order to perform analysis selected by GETSystem::SelectAnalysis function (if not set, the default is to perform no data analysis).

The function does:

call the AnalyseRawEvent() function (if raw data analysis is set)
applies corrections, according to options:
- FPN correction
- output correction processes
reconstruct input channels (if input reconstruction analysis is set)
call the AnalyseCorEvent() function (if corrected data analysis is set)

References AnalyseCorData(), AnalyseCorEvent(), AnalyseInputRec(), analyser, AnalyseRawData(), AnalyseRawEvent(), GET::CoBoData0Correction, GET::CoBoDataNCorrection, GET::CoBoZeroSuppress, GetOptions(), GETSystemAnalyser::IncrAnalysisEventCount(), OutputCorrectData0(), OutputCorrectDataN(), OutputCorrectFPN(), GETSystemAnalyser::OutputCorrection(), GETObject::ProcessOutputCorrection(), GETObject::ProcessRecFromOut(), GET::RCoBoCorrectFPN4, UserCorEvent(), UserRawEvent(), GETObject::ValidDataSet(), zero_threshold, and ZeroSuppression().

Referenced by ReadEvent().

bool GETSystem::AnalyseInputRec ( ) const

inline

Return true if input signal reconstruction analysis flag is set.

References GET::analyseInputRec, and selected_analysis.

Referenced by AnalyseEvent(), and GETActarEventReader::AnalysisEvent().

bool GETSystem::AnalyseRawData ( ) const

inline

Return true if raw data analysis flag is set.

References GET::analyseRaw, and selected_analysis.

Referenced by AnalyseEvent().

int GETSystem::AnalyseRawEvent ( )

virtual

Function called just after the raw data have been read, before automatic corrections are applied. If a non-zero value is returned, it means an error occured and the event reading process is interrupted.

In the base class, the function counts the number of saturated channels. It also calls the associated analyser function (if defined) .

If overloaded in derived classes, the base class function should be called by the derived class function for this counting to be done.

References analyser, GETSystemAnalyser::AnalyseRawEvent(), cor_data, GETObject::GetTotalChannelCount(), IsChannelSaturated(), saturation_count, and saturation_value.

Referenced by AnalyseEvent().

bool GETSystem::AnalysingCor ( ) const

inlinevirtual

Return true if currently processing corrected event data.

References cor_data.

bool GETSystem::AnalysingRaw ( ) const

inlinevirtual

Return true if currently processing raw event data.

References cor_data.

Referenced by GETSystemAnalyser::ComputeAmplitudeData().

u_int GETSystem::CalcMultiplicity ( bool fpn = true )

The function computes the multiplicity of channels, AGet chips, AsAd boards and CoBo modules that contain data. The function returns the channel multiplicity. The multiplicity can be accessed with GetChannelMultiplicity, GetAGetMultiplicity, GetAsAdMultiplicity and GetCoBoMultiplicity functions.

The difference with GETObject::GetReadoutMultiplicity is that the multiplicity is computed once for the event, without analysing children multiplicity each time.

Parameters

fpn	indicates if the FPN channels should be counted

References cobo, cobo_number, GETCoBo::GetChildrenNumber(), GETAsAd::GetChildrenNumber(), GETAGet::GetChildrenNumber(), GETObject::GetReadoutMultiplicity(), mult_aget, mult_asad, mult_channel, and mult_cobo.

Referenced by GETActarEventReader::AnalysisEvent().

bool GETSystem::ChannelHasData ( u_int ic ) const

inline

Return true if the channel contains data after reading an event.

Parameters

ic	channel number

References channel_count, and channel_hit.

Referenced by OutputCorrectData0(), OutputCorrectDataN(), and GETSystemAnalyser::ProcessFluctuationsAnalysis().

int GETSystem::CheckCoBoData	(	u_int	cobo,
		u_int	asad,
		u_int &	aget,
		u_int &	chan,
		u_int &	buck,
		u_int	val
	)

virtual

The arguments aget, chan and buck indicate the data that have been read. In case of problem, they return corrected value if found, or -1 if no correction is found.

Parameters

cobo	CoBo number (for information)
asad	AsAd number (for information)
aget	AGET chip number
chan	Channel number (in AGET)
buck	Time bucket number
val	Sample value (for information)

References GETData::AGet, AGET_SIZE, GETData::AsAd, ASAD_SIZE, bad_cobo_read_check, bad_cobo_read_count, bad_cobo_read_data, GETData::Bucket, GETData::Channel, GETData::CoBo, cobo, cobo_filled, cobo_last_bucket, GET_MAX_DEPTH, GETData::Info, mfm_event_num, GETChannel::OutSample(), GETChannel::read_count, saturation_value, GETChannel::SetReadOk(), GETChannel::UpdateSaturations(), and GETData::Value.

Referenced by ProcessCoBoFrameData().

u_int GETSystem::CheckCoBoFrameBadChannels	(	int	ico,
		int	ias
	)

virtual

Function that searches the number of bad channels from a CoBo (AsAd) frame reading. This function is not adapted to (hardware) zero suppress mode.

Parameters

ico	cobo number
ias	asad number

References GETData::AGet, AGET_SIZE, GETData::AsAd, ASAD_SIZE, bad_cobo_channel_aget, bad_cobo_channel_count, bad_cobo_channel_index, bad_cobo_read_count, bad_cobo_read_data, bad_cobo_read_min, GETData::Bucket, GETData::Channel, GETData::CoBo, GET::CoBoCorrectBadData, GetOption(), GETChannel::GetReadoutCount(), GETObject::GetReadoutFlag(), GETData::Info, GETChannel::IsReadOk(), mfm_event_num, GETChannel::OutSample(), and GETData::Value.

Referenced by ProcessCoBoFrameData().

GETSystem::ClassDef	(	GETSystem	,
		0
	)

for use within ROOT.

void GETSystem::ClearCoBoDataRead ( )

virtual

Clears the memorization arrays of read data in CoBo frame.

References AGET_SIZE, ASAD_SIZE, bad_cobo_read_check, cobo_filled, cobo_last_bucket, and GET_MAX_DEPTH.

Referenced by ProcessCoBoFrameData().

void GETSystem::ClearEvent ( )

virtual

Clears all data from all CoBo modules.

Reimplemented from GETObject.

References analyser, bad_read_count, channel_count, channel_hit, GETSystemAnalyser::ClearEvent(), GETHitMask::ClearHitMask(), cobo, cobo_number, hit_mask, GETObject::is_read, mfm_event_clock, mfm_event_num, mfm_event_set, mfm_event_time, mult_aget, mult_asad, mult_channel, mult_cobo, and saturation_count.

Referenced by GETRCoBo::ReadEvent(), GETActarEventReader::ReadEvent(), and ReadEvent().

int GETSystem::CloseRunFile ( )

virtual

Close current experimental data file. The function returns 0 if no error occured.

Examples:: Demonstrator_RMS1.C, ReadEvent_Demonstrator.cxx, and ReadEvent_RCoBo.cxx.

References analyser, GETSystemAnalyser::AnalyseRunStop(), GETRunFile::Close(), IsRunFileOpen(), and run_file.

Referenced by OpenRunFile(), OpenRunSerie(), Reset(), and ~GETSystem().

u_int GETSystem::CorrectCoBoFrameBadData	(	int	ico,
		int	ias
	)

virtual

Function that tries to correct for bad data read in a CoBo (AsAd) frame. The function checks only the channels that have been identified bad by the CheckCoBoFrameBadChannels function. The function returns the number of fully corrected channels.

Parameters

ico	cobo number
ias	asad number

References GETData::AGet, GETData::AsAd, bad_cobo_channel_aget, bad_cobo_channel_count, bad_cobo_channel_index, bad_cobo_read_count, bad_cobo_read_data, bad_read_count, bad_read_data, GETData::Bucket, GETData::Channel, GETData::CoBo, GETObject::GetReadoutFlag(), GETChannel::IncrReadoutCount(), GETData::Info, GETChannel::IsReadOk(), mfm_event_num, GETChannel::OutSample(), saturation_value, GETChannel::SetReadOk(), GETChannel::SetSaturation(), and GETData::Value.

Referenced by ProcessCoBoFrameData().

int GETSystem::ExtractCoboFrame ( )

virtual

Function extracting information from the CoBo data frame.

Reimplemented in GETActarTpc.

References mfm_frame, options, ProcessCoBoFrameData(), and GET::ProcessSingleFrames.

Referenced by ReadEvent().

int GETSystem::ExtractCoboTopoFrame ( )

virtual

Function extracting information from the CoBo topology frame.

References mfm_frame.

Referenced by ReadEvent().

int GETSystem::ExtractEbyedatFrame ( )

virtual

Function extracting information from the EBYEDAT data frame.

References mfm_frame, options, ProcessEbyedatFrameData(), and GET::ProcessSingleFrames.

Referenced by ReadEvent().

int GETSystem::ExtractMergeFrame ( )

virtual

Function extracting information from a merged frame.

References mfm_frame, and ProcessMergeFrameData().

Referenced by ReadEvent().

int GETSystem::ExtractXMLFileHeaderFrame ( )

virtual

Function extracting information from the file header frame.

References mfm_frame.

Referenced by ReadEvent().

int GETSystem::GetAcqEventNumber ( ) const

inline

Return the GET acquisition event number.

References mfm_event_num.

Referenced by GETActarEventReader::ReadEvent(), and GETActarEventReader::UpdateDisplay().

double GETSystem::GetAcqEventTimeSec ( ) const

inline

Return the GET acquisition event time in seconds.

References mfm_event_time.

Referenced by GETActarEventReader::ReadEvent().

uint64_t GETSystem::GetAcqEventTimeStamp ( ) const

inline

Return the GET acquisition event time stamp.

References mfm_event_clock.

u_int GETSystem::GetAGetMultiplicity ( ) const

inline

Return the total number of AGet with data (computed with CalcMultiplicity function).

References mult_aget.

GETSystemAnalyser * GETSystem::GetAnalyser ( ) const

inline

Function returning the pointer to the data analyser.

References analyser.

Referenced by GETHitMaskXY::SetValidChannels().

u_short GETSystem::GetAnalysisFlags ( ) const

inline

Return the selected analysis flags.

References selected_analysis.

Referenced by GETSystemAnalyser::ConfigCommand(), and GETActarEventReader::ReadEvent().

u_int GETSystem::GetAsAdMultiplicity ( ) const

inline

Return the total number of AsAd with data (computed with CalcMultiplicity function).

References mult_asad.

u_int GETSystem::GetAsAdNumber ( ) const

virtual

Return the number of AsAd boards controlled by the module.

References cobo, and cobo_number.

Referenced by ProcessMergeFrameData().

u_int GETSystem::GetBadReadCount ( ) const

inline

Return the number of bad data read in the CoBo frames.

References bad_read_count.

const GETData * GETSystem::GetBadReadData ( ) const

inline

Return the pointer to the array of bad data read in the CoBo frames.

References bad_read_data.

GETData * GETSystem::GetBadReadData ( )

inline

Return the pointer to the array of bad data read in the CoBo frames.

References bad_read_data.

GETChannel * GETSystem::GetChannel	(	int	ix,
		int	iy
	)		const

inlinevirtual

Return the channel pointer from pad position.

Parameters

ix	X pad index
iy	Y pad index

Examples:: Demonstrator_RMS1.C.

References channel_summary, GETLookupTable::GetChannel(), and lookup_table.

GETChannel * GETSystem::GetChannel ( u_int n )

inlinevirtual

Return a channel (signal or FPN) from the object The function returns NULL if the channel does not exist.

Parameters

n	channel number

Reimplemented from GETObject.

References channel_count, and channel_summary.

u_int GETSystem::GetChannelCount ( ) const

inlinevirtual

Return the total number of channels, including FPNs.

Reimplemented from GETObject.

References channel_count.

int GETSystem::GetChannelIndex ( const GETChannel * ch )

virtual

Return the index of a channel in the GET system. If the channel is not found, the function returns -1.

Parameters

ch	pointer to channel object

References channel_count, and channel_summary.

Referenced by GETActarEventReader::PresetChannelParam().

int GETSystem::GetChannelIndex	(	int	ix,
		int	iy
	)		const

inlinevirtual

Return the electronics channel index (including FPN) from pad position.

Parameters

ix	X pad index
iy	Y pad index

References GETLookupTable::GetChannel(), and lookup_table.

u_int GETSystem::GetChannelMultiplicity ( ) const

inline

Return the number of Channels with data (computed with CalcMultiplicity function).

References mult_channel.

const GETObject * GETSystem::GetChild ( u_int i ) const

inlinevirtual

Return a GET core child object (NULL since channels have no children).

Parameters

i	child number

Implements GETObject.

References cobo, and cobo_number.

Referenced by GETCfgSetup::GETCfgSetup().

GETObject * GETSystem::GetChild ( u_int i )

inlinevirtual

Return a GET core child object (NULL since channels have no children).

Parameters

i	child number

Implements GETObject.

References cobo, and cobo_number.

u_int GETSystem::GetChildrenNumber ( ) const

inlinevirtual

Return the number of GET core children objects.

Implements GETObject.

References cobo_number.

Referenced by GETSystemAnalyser::BadChannelsWarning(), GETHitMask::CreateThresholdXML(), GETActarEventReader::DefineElecSpectrum(), and OutputCorrectFPN().

u_int GETSystem::GetCoBoFrameError ( ) const

inline

Return the number of CoBo frames read in run, that contain errors.

References cobo_frame_error.

u_int GETSystem::GetCoBoFrameRead ( ) const

inline

Return the number of CoBo frames read in run.

References cobo_frame_read.

u_int GETSystem::GetCoBoFrameRecover ( ) const

inline

Return the number of CoBo frames read in run, that contain errors and could be recovered.

References cobo_frame_recover.

u_int GETSystem::GetCoBoMultiplicity ( ) const

inline

Return the number of CoBo with data (computed with CalcMultiplicity function).

References mult_cobo.

u_int GETSystem::GetCoBoNumber ( ) const

inlinevirtual

Return the number of CoBo modules controlled by the module.

References cobo_number.

Referenced by GETSystemAnalyser::BadDataNumberCorrect(), GETActarEventReader::DefineElecSpectrum(), GETCfgSetup::GETCfgSetup(), GETActarEventReader::GETInit(), GETActarEventReader::PresetAgetPage(), GETActarEventReader::PresetChannelParam(), GETActarEventReader::PresetSystemAnalysis(), and GETSystemAnalyser::ProcessFPNtestAnalysis().

const GETCfgSetup * GETSystem::GetConfig ( ) const

inline

Return the pointer to the related GET configuration.

References config.

GETCfgSetup * GETSystem::GetConfig ( )

inline

Return the pointer to the related GET configuration.

References config.

MFMCommonFrame * GETSystem::GetCurrentMFMFrame ( )

inline

Return the pointer to the MFM frame.

References mfm_frame.

u_int GETSystem::GetEventCount ( ) const

inline

Return the number of events read from input file.

References event_count.

Referenced by GETSystemAnalyser::ProcessDataContinuityCheck(), GETSystemAnalyser::ProcessFluctuationsAnalysis(), and GETSystemAnalyser::ProcessFPNtestAnalysis().

GETHitMask * GETSystem::GetHitMask ( ) const

inline

Return the pointer to the hit mask.

References hit_mask.

Referenced by GETSystemAnalyser::ConfigCommand(), GETActarTpcAnalyser::ProcessOffTrackAnalysis(), GETActarTpcAnalyser::SetSystem(), and GETSystemAnalyser::SetSystem().

GETChannel * GETSystem::GetMaximumChannel	(	u_short	info = `GET::signalOut`,
		bool	integ = `false`
	)

virtual

Return a pointer to the channel with maximum signal (amplitude or integral signal). The FPN channels are not checked.

Parameters

info	samples used for filling: GET::signalOut (default) GET::signalTst or GET::signalRec
integ	whether the integral is checked instead of amplitude

References channel_count, channel_summary, GETChannel::IsSignalChannel(), GETChannel::OutSample(), GETChannel::RecSample(), GET::signalRec, GET::signalTst, and GETChannel::TstSample().

string GETSystem::GetObjectId ( ) const

inlinevirtual

Return the object string identifier.

Implements GETObject.

bool GETSystem::GetOption ( u_int flags )

inlinestatic

Get the status of selected options for the GET system (true if all selected options are ON).

Parameters

flags checked options

References options.

Referenced by CheckCoBoFrameBadChannels(), OutputCorrectFPN(), ProcessCoBoFrameData(), and GETRCoBo::ReadEvent().

u_int GETSystem::GetOptions ( )

inlinestatic

Get the options for the GET system.

References options.

Referenced by AnalyseEvent(), and GETRCoBo::ReadEvent().

u_int GETSystem::GetOutputData0correction ( ) const

inline

Return the size of data correction at beginning of time samples.

References data0_num.

u_int GETSystem::GetOutputDataNcorrection ( ) const

inline

Return the size of data correction at end of time samples.

References dataN_num.

GETRunFile * GETSystem::GetRunFile ( )

inline

Return the pointer to the run file(s) object;

References run_file.

string GETSystem::GetRunFileName ( ) const

inline

Return the name of current experimental data file.

References GETRunFile::GetFileName(), and run_file.

int GETSystem::GetSaturationCount ( ) const

inlinevirtual

Function returning the number of saturated channels.

References saturation_count.

Referenced by GETActarEventReader::AnalysisEvent(), and IsChannelSaturated().

int GETSystem::GetSaturationValue ( ) const

inlinevirtual

Function returning the coder value above which a channel is considered saturated.

References saturation_value.

GETChannel * GETSystem::GetTestChannel ( )

inlinevirtual

Return the pointer to the (debug) test channel, or NULL if undefined.

References channel_count, channel_summary, and test_channel.

Referenced by SetTestChannel().

int GETSystem::GetTestChannelIndex ( )

inlinevirtual

Return the index of the (debug) test channel (-1 if undefined).

References test_channel.

Referenced by GETActarTpcAnalyser::ApplyOffTrackCorrection(), GETSystemAnalyser::CalcChannelAmplitude(), GETSystemAnalyser::CalcChannelMaxima(), GETSystemAnalyser::ComputeAmplitudeData(), and GETSystemAnalyser::SetChannelFctParameters().

GETSystem::GObject ( GETSystem )

private

Macro from GCpp library that defines the following functions:

ClassName(): return the real class name of the object
StaticClassName(): return the used class name of the object (that may be a base class of the real object).
IsInstanceOf<T>(): return true if the current object is an instance of the template class name argument
Clone(): return an allocated copy of the object.

void GETSystem::IncrEventCount ( )

inline

Increment the event counter. The event counter is incremented automatically with ReadEvent function, but in the case of events processing from frames read out of the class (i.e. online analysis), the counter needs to be incremented manually.

References event_count.

int GETSystem::Init	(	u_int	n_cobo,
		u_int	n,
		double	dt
	)

virtual

Initialize the CoBo modules with 4 AsAd boards. If the number of CoBo modules is modified, they are recreated. In any case, they are resetted.

The function returns 0 if no error occured.

Warning: the look-up table and the hit mask must be redefined if needed after a call the the Init function.

Parameters

n_cobo	number of CoBo modules
n	dimension of data samples
dt	sampling period (us)

Reimplemented in GETRCoBo.

References channel_count, channel_hit, channel_summary, cobo, cobo_number, GETLookupTable::EraseTables(), GETObject::GetTotalChannel(), GETObject::GetTotalChannelCount(), GETObject::id, GETCoBo::Init(), GETObject::InitLocalData(), lookup_table, GETObject::parent, Reset(), and SetHitMask().

Referenced by GETRCoBo::Init(), and GETActarTpc::Init().

int GETSystem::InitConfig ( )

virtual

Create the configuration architecture. This function should be called after the GET core system has been fully defined.

Examples:: ReadConfig.cxx.

References config, and ResetConfig().

bool GETSystem::IsChannelSaturated ( u_int ich )

inlinevirtual

The function returns true if the number of channel data over saturation threshold is at least the saturation multiplicity.

Parameters

ich	channel index

References GetSaturationCount(), GETObject::GetTotalChannel(), and saturation_mult.

Referenced by AnalyseRawEvent(), GETSystemAnalyser::CumulChannelsSummaryHisto(), and GETSystemAnalyser::FillChannelsSummaryHisto().

bool GETSystem::IsChannelSaturated ( const GETChannel & ch )

inlinevirtual

The function returns true if the number of channel data over saturation threshold is at least the saturation multiplicity.

Parameters

ch	channel reference

References GETChannel::GetSaturationCount(), and saturation_mult.

bool GETSystem::IsRunFileOpen ( ) const

inline

Return whether an experimental data file is currently open.

References GETRunFile::IsOpen(), and run_file.

Referenced by CloseRunFile(), GETActarEventReader::IsOpen(), GETActarEventReader::Open(), OpenRunFile(), OpenRunSerie(), GETRCoBo::ReadEvent(), ReadEvent(), Reset(), and ~GETSystem().

const GETLookupTable & GETSystem::LookupTable ( ) const

inline

Return the look-up table (by reference).

References lookup_table.

GETLookupTable & GETSystem::LookupTable ( )

inline

Return the look-up table (by reference).

References lookup_table.

int GETSystem::OpenRunFile ( const string & fname )

virtual

Open an experimental data file. If the file name contains a '*' character, a file list is created instead of a single file. The function returns 0 if no error occured.

Parameters

fname file name

Examples:: Demonstrator_RMS1.C, ReadEvent_Demonstrator.cxx, ReadEvent_RCoBo.cxx, and ReadRCoBo.C.

References analyser, GETSystemAnalyser::AnalyseRunStart(), CloseRunFile(), event_count, IsRunFileOpen(), mfm_frame_count, GETRunFile::Open(), and run_file.

Referenced by GETActarEventReader::Open().

int GETSystem::OpenRunSerie	(	const string &	pattern,
		const string &	serie
	)

virtual

Open a serie of run files. The function returns 0 if no error occured.

Parameters

pattern	pattern to select run files, with "%R" or "%<n>R" indicating the run number position
serie	string indicating the list of run numbers

References analyser, GETSystemAnalyser::AnalyseRunStart(), CloseRunFile(), event_count, IsRunFileOpen(), mfm_frame_count, GETRunFile::Open(), and run_file.

const GETCoBo & GETSystem::operator[] ( u_int n ) const

inline

Access to one of the CoBo module. There is no index verification.

Parameters

n	CoBo number

References cobo.

GETCoBo & GETSystem::operator[] ( u_int n )

inline

Access to one of the CoBo module. There is no index verification.

Parameters

n	CoBo number

References cobo.

int GETSystem::OutputCorrectData0 ( )

virtual

Function correcting data-0 (first time buckets) of output samples. The first data of each output sample are set to 0. This correction is required when running with reduced readout depth (in full readout mode) with CoBo firmware 2017/02: the first data often contains junk values while the other data seem to be correct. The function returns 0 if no error occured.

References channel_count, channel_summary, ChannelHasData(), data0_num, and GETChannel::OutSample().

Referenced by AnalyseEvent().

int GETSystem::OutputCorrectDataN ( )

virtual

Function correcting data-N (last time buckets) of output samples. The last data of each output sample are set to 0. The function returns 0 if no error occured.

References channel_count, channel_summary, ChannelHasData(), dataN_num, GETObject::GetSampleDim(), and GETChannel::OutSample().

Referenced by AnalyseEvent().

int GETSystem::OutputCorrectFPN ( u_int opt_fpn = GET::CoBoCorrectFPN4 )

virtual

Function correcting event output samples for FPN. The argument overrides the GET system current option. Only the signal channels are affected. The function returns 0 if no error occured.

Parameters

opt_fpn FPN correction option (see GET namespace)

References AGET_CHANNELS, AGET_SIZE, ASAD_SIZE, channel_hit, GETAGet::CloserFPNIndex(), cobo, COBO_SIZE, GET::CoBoCorrectFPN4, GETObject::GetChannel(), GetChannel(), GetChildrenNumber(), GETObject::GetId(), GetOption(), GETChannel::IsFPNChannel(), GETChannel::OutSample(), GET::RCoBoCorrectFPN2, GET::RCoBoCorrectFPN4, and test_channel.

Referenced by AnalyseEvent().

int GETSystem::ProcessCoBoFrameData ( MFMCoboFrame * frame )

virtual

Function extracting the data from a CoBo frame.

Parameters

frame pointer to the frame to be analysed

References GETData::AGet, AGET_SIZE, analyser, GETData::AsAd, ASAD_SIZE, bad_cobo_channel_count, bad_cobo_read_count, bad_cobo_read_data, bad_read_count, bad_read_data, GETData::Bucket, GETData::Channel, channel_hit, CheckCoBoData(), CheckCoBoFrameBadChannels(), ClearCoBoDataRead(), GETData::CoBo, cobo, cobo_filled, cobo_frame_error, cobo_frame_read, cobo_frame_recover, cobo_last_bucket, COBO_SIZE, GET::CoBoCorrectBadData, CorrectCoBoFrameBadData(), GET_BAD_READ_MAX, GET_MAX_DEPTH, GetOption(), GETChannel::IncrReadoutCount(), GETData::Info, GETSystemAnalyser::IsDataNumberCheckON(), GETChannel::IsReadOk(), mfm_event_clock, mfm_event_num, mfm_event_set, mfm_event_time, GET::NoCoBoFrameUnpack, options, GETChannel::OutSample(), saturation_value, GETChannel::SetReadOk(), GETObject::SetReadoutFlag(), GETChannel::SetSaturation(), and GETData::Value.

Referenced by GETActarTpc::ExtractCoboFrame(), ExtractCoboFrame(), ProcessFrameData(), and ProcessMergeFrameData().

int GETSystem::ProcessEbyedatFrameData ( MFMEbyedatFrame * frame )

virtual

Function extracting the data from a EBYEDAT frame.

Parameters

frame pointer to the frame to be analysed

Referenced by ExtractEbyedatFrame(), ProcessFrameData(), and ProcessMergeFrameData().

int GETSystem::ProcessFrameData ( MFMCommonFrame * frame )

virtual

Function extracting the data from an external MFM frame.

Parameters

frame pointer to the frame to be analysed

References ProcessCoBoFrameData(), ProcessEbyedatFrameData(), ProcessMergeFrameData(), and UserAnyFrame().

int GETSystem::ProcessMergeFrameData ( MFMMergeFrame * frame )

virtual

Function extracting the data from an external MFM Merge frame.

Parameters

frame pointer to the frame to be analysed

References GET_FRAME_ERROR, GET_FRAME_WARN, GetAsAdNumber(), GET::MergedIncompleteError, GET::MergedIncompleteSkip, mfm_event_clock, mfm_event_num, mfm_event_set, mfm_event_time, mfm_frame_count, options, ProcessCoBoFrameData(), ProcessEbyedatFrameData(), UserCoBoFrame(), UserEbyedatFrame(), UserMergeFrame(), and GETObject::ValidDataSet().

Referenced by ExtractMergeFrame(), and ProcessFrameData().

int GETSystem::ReadEvent ( )

virtual

Read next event in current file. The function returns -1 if end of file is reached (no event read) or a positive value is case of error.

After an event has been read, the channels are set to experimental mode, and all channels output are set to valid (and other signals must be recomputed).

The function does:

read a raw event
call the AnalyseEvent() function

Reimplemented in GETActarEventReader.

Examples:: Demonstrator_RMS1.C, and ReadEvent_Demonstrator.cxx.

References AnalyseEvent(), GETRunFile::AtEnd(), ClearEvent(), cor_data, event_count, ExtractCoboFrame(), ExtractCoboTopoFrame(), ExtractEbyedatFrame(), ExtractMergeFrame(), ExtractXMLFileHeaderFrame(), GET_EOF, GET_FILE_ERROR, GETRunFile::GetFileLun(), IsRunFileOpen(), mfm_buffer_adr, mfm_buffer_size, mfm_frame, mfm_frame_count, GETRunFile::OpenNext(), run_file, and selected_analysis.

Referenced by GETActarEventReader::ReadEvent().

int GETSystem::ReadXMLConfig ( const string & fname )

inlinevirtual

Read the setup configuration file.

Parameters

fname file name

Examples:: ReadConfig.cxx.

References config, and GETCfgSetup::ReadXMLConfig().

void GETSystem::Reset ( )

virtual

Function resetting all CoBo modules (see GETCoBo::Reset function). The array of CoBo modules is not deleted, and the number of CoBo modules is not modified. The function also closes input file and resets counters.

Reimplemented in GETActarEventReader.

References CloseRunFile(), cobo, cobo_frame_error, cobo_frame_read, cobo_frame_recover, cobo_number, event_count, IsRunFileOpen(), mfm_event_clock, mfm_event_num, mfm_event_time, and GETCoBo::Reset().

Referenced by Init(), and GETActarEventReader::Reset().

int GETSystem::ResetConfig ( )

virtual

Removes the configuration architecture.

References cobo_number, and config.

Referenced by InitConfig().

void GETSystem::SelectAnalysis ( u_short sel )

inlinevirtual

Set the analysis selection

Parameters

sel	selected analysis flags: GET::analyseRaw, GET::analyseCor, analyseInputRec

References GET::analyseRecAll, and selected_analysis.

int GETSystem::SetAnalyser ( GETSystemAnalyser * a )

virtual

Set a data analyser associated to the GET system. If the analyser pointer is NULL, a previously defined analyser is deleted. The function return 0 if no error occured.

Parameters

a	pointer to the analyser

References analyser, and GETSystemAnalyser::SetSystem().

Referenced by GETActarEventReader::DefineAnalyser().

void GETSystem::SetAnalysis	(	u_short	sel,
		bool	b = `true`
	)

inlinevirtual

Set the analysis flags ON / OFF.

Parameters

sel	selected analysis flags: GET::analyseRaw, GET::analyseCor, analyseInputRec
b	analysis ON / OFF

References selected_analysis.

Referenced by GETSystemAnalyser::ConfigCommand(), SetCorDataAnalysis(), SetInputRecAnalysis(), and SetRawDataAnalysis().

int GETSystem::SetAsAdResponseFunctions ( const string & rf_file )

virtual

Function setting the response function from single AsAd response files, identified with the AsAd serial numbers for each board of the GET system.

References ASAD_SERIAL_UNDEF, cobo_number, COBO_SIZE, GETAsAd::GetSerialId(), and GETAsAd::SetResponseFunctions().

Referenced by SetResponseFunctions().

int GETSystem::SetAutoBaseline	(	u_short	num_lo,
		u_short	off_lo,
		u_short	num_hi = `0`,
		u_short	off_hi = `0`
	)

virtual

Function setting the automatic linear baseline correction for the GET system. It is set recursively to all children, down to the signal channels.

If not already set, the function starts attributing a process serie for all output corrections

The function returns 0 if no error occured.

Parameters

num_lo	number of buckets in the low part of the sample
off_lo	buckets offset from first bucket
num_hi	number of buckets in the high part of the sample
off_hi	buckets offset from last bucket

References GETObject::AddOutputCorrection(), GETObject::GetOutputCorrection(), GETObject::GetSampleDim(), GETObject::GetTimeStep(), and GETObject::SetOutputCorrectionList().

Referenced by GETSystemAnalyser::ConfigCommand().

int GETSystem::SetAutoBLoffset	(	u_short	itmin,
		u_short	itmax
	)

virtual

Function setting automatic baseline off set correction for the GET system. It is set recursively to all children, down to the signal channels.

If not already set, the function starts attributing a process serie for all output corrections

The function returns 0 if no error occured.

Parameters

itmin	lower time bucket for offset estimate (included)
itmax	upper time bucket for offset estimate (excluded)

References GETObject::AddOutputCorrection(), GETObject::GetOutputCorrection(), GETObject::GetSampleDim(), GETObject::GetTimeStep(), and GETObject::SetOutputCorrectionList().

Referenced by GETSystemAnalyser::ConfigCommand().

void GETSystem::SetBadDataCorrection ( bool b )

inline

Set the option for the CoBo/AsAd frames bad data correction.

Parameters

b	option on/off

References GET::CoBoCorrectBadData, and options.

int GETSystem::SetBaselineCorrection ( const string & bl_file )

virtual

Function setting the baseline correction for each channel of the GET system.

A process is attributed only to signal channels (not FPN). If not already set, the function starts attributing a process serie for all output corrections

The file must contain the exact number of samples (including FPN channels) previously stored with the sample format (with GETSample::Write function).

The function returns 0 if no error occured.

Parameters

bl_file baselines file (1 sample per channel)

References GETObject::AddOutputCorrection(), GetChannel(), GETObject::GetOutputCorrection(), GETObject::GetSampleDim(), GETObject::GetTimeStep(), GETObject::GetTotalChannelCount(), and GETObject::SetOutputCorrectionList().

Referenced by GETSystemAnalyser::ConfigCommand().

int GETSystem::SetCalibProcess	(	const string &	calib_file,
		u_short	opt = `0`
	)

virtual

Function setting the calibration process for each channel of the GET system.

A process is attributed only to signal channels (not FPN). If not already set, the function starts attributing a process serie for all output corrections

The function returns 0 if no error occured.

Parameters

calib_file	calibration file
opt	option flags for the calibration 0x0001 set constant offset to 0

References GETObject::AddOutputCorrection(), GetChannel(), GETObject::GetOutputCorrection(), GETObject::GetSampleDim(), GETObject::GetTimeStep(), GETChannel::IsSignalChannel(), GETCalibProcess::SetCoefficient(), GETCalibProcess::SetDegree(), and GETObject::SetOutputCorrectionList().

Referenced by GETSystemAnalyser::ConfigCommand().

void GETSystem::SetCorDataAnalysis ( bool b = true )

inlinevirtual

Set the corrected data analysis ON / OFF.

Parameters

b	analysis ON / OFF

References GET::analyseCor, and SetAnalysis().

Referenced by GETSystemAnalyser::ConfigCommand().

GETHitMask * GETSystem::SetHitMask ( GETHitMask * mask )

virtual

Defines the hit mask associated to the channels. The hit mask is adopted by the GETSystem system objet (the mask will be deleted when the GETSystem object is destroyed). If a hit mask was previous set, deletes the previous one. If an analyser (GETSystemAnalyser) is defined, the mask pointer is modified for the analyser. If the argument is a NULL pointer, the current hit mask is removed. The function returns the hit mask pointer if properly set, a NULL pointer otherwise.

Parameters

mask	pointer to the hit mask

References analyser, hit_mask, and GETSystemAnalyser::hit_mask.

Referenced by Init(), and GETActarTpc::SetHitMask().

void GETSystem::SetInputRecAnalysis ( bool b = true )

inlinevirtual

Set the input signal reconstruction ON / OFF.

Parameters

b	analysis ON / OFF

References GET::analyseInputRec, and SetAnalysis().

Referenced by GETSystemAnalyser::ConfigCommand(), GETActarEventReader::ReadEvent(), and GETSystemAnalyser::SetSelectedSignalData().

void GETSystem::SetOption	(	u_int	flags,
		bool	b = `true`
	)

inlinestatic

Set selected options for the GET system.

Parameters

flags	chosen options
b	options value (on/off)

References options.

Referenced by GETSystemAnalyser::ConfigCommand(), SetOutputData0correction(), SetOutputDataNcorrection(), and SetZeroSuppressMode().

void GETSystem::SetOptions ( u_int opts )

inlinestatic

Set all options for the GET system.

Parameters

opts	selected options

References options.

Referenced by GETActarEventReader::ConfigCommand(), and GETActarEventReader::GETInit().

void GETSystem::SetOutputData0correction ( u_int n )

Set the first samples data (time buckets) correction. If the argument is 0, the correction is cancelled, otherwise the correction is set and the arument is the number of time buckets to set to 0.

The Data-0 correction is applied after the output correction processes (FPN, baseline, calibration...), and before the output corrections from the analyser -if defined).

Parameters

n	number of data to set to 0

References GET::CoBoData0Correction, data0_num, GETObject::GetSampleDim(), and SetOption().

Referenced by GETSystemAnalyser::ConfigCommand().

void GETSystem::SetOutputDataNcorrection ( u_int n )

Set the last samples data (time buckets) correction. If the argument is 0, the correction is cancelled, otherwise the correction is set and the arument is the number of time buckets to set to 0.

The Data-N correction is applied after the output correction processes (FPN, baseline, calibration...), and before the output corrections from the analyser -if defined).

Parameters

n	number of data to set to 0

References GET::CoBoDataNCorrection, dataN_num, GETObject::GetSampleDim(), and SetOption().

int GETSystem::SetOutputSmoothing ( double width )

virtual

Function adding a smoothing filter to the output signals correction. It is set recursively to all children, down to the signal channels.

If not already set, the function starts attributing a process serie for all output corrections

The function returns 0 if no error occured.

Parameters

width width (FWHM) of the smoothing Gauss function

References GETObject::AddOutputCorrection(), GETObject::GetOutputCorrection(), GETObject::GetSampleDim(), GETObject::GetTimeStep(), and GETObject::SetOutputCorrectionList().

Referenced by GETSystemAnalyser::ConfigCommand().

void GETSystem::SetRawDataAnalysis ( bool b = true )

inlinevirtual

Set the raw data analysis ON / OFF.

Parameters

b	analysis ON / OFF

References GET::analyseRaw, and SetAnalysis().

Referenced by GETSystemAnalyser::ConfigCommand().

int GETSystem::SetResponseFunctions ( const string & rf_file )

virtual

Function setting the response function.

References SetAsAdResponseFunctions().

Referenced by GETSystemAnalyser::ConfigCommand().

void GETSystem::SetSaturationValue ( int val )

inlinevirtual

Function setting the coder value above which a channel is considered saturated.

Parameters

val	coder value for saturation

References saturation_value.

GETChannel * GETSystem::SetTestChannel ( int ic )

inlinevirtual

Select the (debug) test channel, the pointer is returned.

Parameters

ic	test channel index

References GetTestChannel(), and test_channel.

Referenced by GETSystemAnalyser::ConfigCommand().

int GETSystem::SetTimeCorrectionProcess ( const string & shift_file )

virtual

Function setting a time shift process for each channel of the GET system.

A process is attributed only to signal channels (not FPN). If not already set, the function starts attributing a process serie for all output corrections

The function returns 0 if no error occured.

Parameters

shift_file file with time shift for all channels

References GETObject::AddOutputCorrection(), GetChannel(), GETObject::GetOutputCorrection(), GETObject::GetSampleDim(), GETObject::GetTimeStep(), GETChannel::IsSignalChannel(), and GETObject::SetOutputCorrectionList().

Referenced by GETSystemAnalyser::ConfigCommand().

void GETSystem::SetZeroSuppressMode ( double thr = 0. )

virtual

Set / remove the zero suppression mode. If the threshold is larger than 1, then the zero suppression is activated with the given threshold value. Else, the zero suppression mode is set off. When set on, this mode inhibits the FPN and the automatic baseline corrections.

Parameters

thr	threshold below which values are set to 0.

References GET::CoBoZeroSuppress, SetOption(), and zero_threshold.

int GETSystem::UserAnyFrame ( MFMCommonFrame & frame )

inlinevirtual

Function called after any kind of frame was read. A positive return value is considered as an error.

This function is called before the specific frames types user functions

In this base class, the function does nothing.

Parameters

frame frame data

Referenced by ProcessFrameData().

int GETSystem::UserCoBoFrame ( MFMCoboFrame & frame )

inlinevirtual

Function called after a CoBo frame (single AsAd) was read. A positive return value is considered as an error. In this base class, the function does nothing.

Parameters

frame frame data

Referenced by ProcessMergeFrameData().

int GETSystem::UserCorEvent ( )

inlinevirtual

Function called after the corrected / reconstructed data analysis.

Reimplemented in GETActarEventReader.

Referenced by AnalyseEvent().

int GETSystem::UserEbyedatFrame ( MFMEbyedatFrame & frame )

inlinevirtual

Function called after an Ebyedat frame was read. A positive return value is considered as an error. In this base class, the function does nothing.

Parameters

frame frame data

Referenced by ProcessMergeFrameData().

int GETSystem::UserMergeFrame ( MFMMergeFrame & frame )

inlinevirtual

Function called after a merge frame was read. A positive return value is considered as an error. In this base class, the function does nothing.

Parameters

frame frame data

Referenced by ProcessMergeFrameData().

int GETSystem::UserRawEvent ( )

inlinevirtual

Function called after the raw data analysis.

Reimplemented in GETActarEventReader.

Referenced by AnalyseEvent().

int GETSystem::ZeroSuppression ( double thr = 0. )

virtual

Function setting the values below the threshold to 0, in the output samples of all channels.

Parameters

thr	zero suppression threshold

References channel_count, GetChannel(), GETObject::GetSampleDim(), GETChannel::OutSample(), and test_channel.

Referenced by AnalyseEvent().

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

Public Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Friends

Options functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation