GETActarTpc Class Reference

#include <GETActarTpc.hh>

Inheritance diagram for GETActarTpc:

Public Member Functions
Constructors, affectation, destructor
	GETActarTpc (u_int nx=0, u_int ny=0, u_int dim=0, double dt=0.01L)
virtual	~GETActarTpc ()
System setting
virtual int	Init (u_int nx, u_int ny, u_int n, double dt)
virtual GETHitMask *	SetHitMask (GETHitMaskXY *mask)
const GETHitMaskXY *	GetPadMask () const
GETHitMaskXY *	GetPadMask ()
Experimental data readout
virtual int	ExtractCoboFrame ()
Events information
virtual GETChannel *	GetMaxSignalChannel (int *ipx=NULL, int *ipy=NULL, int *ipt=NULL)
virtual int	GetSignalBoundaries (int &ixmin, int &ixmax, int &iymin, int &iymax, int &itmin, int &itmax)
virtual int	GetSignalBoundaries (int &ixmin, int &ixmax, int &iymin, int &iymax)
virtual int	GetSignalBoundaries (double &xmin, double &xmax, double &ymin, double &ymax, double &tmin, double &tmax)
virtual int	GetSignalBoundaries (double &xmin, double &xmax, double &ymin, double &ymax)
ROOT related functions
	ClassDef (GETActarTpc, 0)
Public Member Functions inherited from GETSystem
	GETSystem (u_int n_cobo=1, u_int dim=0, double dt=0.01L)
virtual	~GETSystem ()
virtual int	ResetConfig ()
virtual int	InitConfig ()
const GETCfgSetup *	GetConfig () const
GETCfgSetup *	GetConfig ()
virtual int	ReadXMLConfig (const string &fname)
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
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)
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
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)
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	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)
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.)
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)
	ClassDef (GETSystem, 0)
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)
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
GETHitMaskXY *	pad_mask
	Pointer to the hit mask (same as base class hit mask, but known as GETHitMaskXY)
Protected Attributes inherited from GETSystem
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.

Private Member Functions
	GObject (GETActarTpc)

Friends
class	GETHitMaskXY

Additional Inherited Members
Static Public Member Functions inherited from GETSystem
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)
Static Protected Attributes inherited from GETSystem
static u_int	options = 0
	Options for GET system.

Detailed Description

This class defines a the GET system for the ACTAR TPC detectors.

The GETActarTpc class proposes the allocation of histograms that can be filled automatically when a new event is read:

• all channels sumary (raw data and/or after corrections)
• amplitude and time pattern of pads signal. They require the look-up table to be defined (except for the raw data summary).

Constructor & Destructor Documentation

GETActarTpc::GETActarTpc	(	u_int	nx = 0,
		u_int	ny = 0,
		u_int	n = 0,
		double	dt = 0.01L
	)

Constructor. If the pad numbers are not 0, the default look-up table and the hit mask (GETHitMaskXY) are automatically defined, otherwise they will be defined when the system is initialized.

Parameters

nx	number pads along X direction
ny	number pads along Y direction
n	dimension of data samples
dt	sampling period (us)

References Init().

GETActarTpc::~GETActarTpc ( )

virtual

Destructor.

Member Function Documentation

GETActarTpc::ClassDef	(	GETActarTpc	,
		0
	)

for use within ROOT.

int GETActarTpc::ExtractCoboFrame ( )

virtual

Function extracting information from the CoBo data frame. It is overloaded from GETSystem to avoid processing individual CoBo/AsAd frames.

Reimplemented from GETSystem.

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

GETChannel * GETActarTpc::GetMaxSignalChannel ( int *  ipx = NULL, int *  ipy = NULL, int *  ipt = NULL  )

virtual

The function returns the pointer to the channel that contains the maximum signal (amplitude). Only channels with signal above threshold argument are considered. If no channel is found, then the function returns NULL. The FPN channels are not considered.

Parameters

ipx	if not NULL, the pointer receives the X pad index
ipy	if not NULL, the pointer receives the Y pad index
ipt	if not NULL, the pointer receives the time bucket with max. value

References GETHitMaskXY::GetMaxSignalChannel(), GETHitMaskXY::GetMaxSignalIT(), GETHitMaskXY::GetMaxSignalIX(), GETHitMaskXY::GetMaxSignalIY(), GETHitMask::IsMaskSet(), pad_mask, and GETHitMask::UpdateMask().

const GETHitMaskXY * GETActarTpc::GetPadMask ( ) const

inline

Return the pointer to the pad-plane hit-mask (XY).

References pad_mask.

GETHitMaskXY * GETActarTpc::GetPadMask ( )

inline

Return the pointer to the pad-plane hit-mask (XY).

References pad_mask.

int GETActarTpc::GetSignalBoundaries ( int &  ixmin, int &  ixmax, int &  iymin, int &  iymax, int &  itmin, int &  itmax  )

inlinevirtual

Function returning the X, Y and T boundaries of the signal. The boundaries are expressed in terms of bin numbers.

The function returns the number of channels for which the signal is over the threshold.

Parameters

ixmin	lower bin on X axis
ixmax	upper bin on X axis
iymin	lower bin on Y axis
iymax	upper bin on Y axis
itmin	lower bin on T axis
itmax	upper bin on T axis

References GETHitMaskXY::GetBoundaries(), and pad_mask.

Referenced by GETActarEventReader::AnalysisEvent(), GetSignalBoundaries(), and GETActarTpcAnalyser::ProcessOffTrackAnalysis().

int GETActarTpc::GetSignalBoundaries ( int &  ixmin, int &  ixmax, int &  iymin, int &  iymax  )

inlinevirtual

Function returning the X and Y boundaries of the signal. The boundaries are expressed in terms of bin numbers.

The function returns the number of channels for which the signal is over the threshold.

Parameters

ixmin	lower bin on X axis
ixmax	upper bin on X axis
iymin	lower bin on Y axis
iymax	upper bin on Y axis

References GETHitMaskXY::GetBoundaries(), and pad_mask.

int GETActarTpc::GetSignalBoundaries ( double &  xmin, double &  xmax, double &  ymin, double &  ymax, double &  tmin, double &  tmax  )

virtual

Function returning the X, Y and T boundaries of the signal. The boundaries are expressed in terms of physical units (corresponding to bin center).

The function returns the number of channels for which the signal is over the threshold.

Parameters

xmin	lower value on X axis
xmax	upper value on X axis
ymin	lower value on Y axis
ymax	upper value on Y axis
tmin	lower value on T axis
tmax	upper value on T axis

References GETSystem::channel_summary, GetSignalBoundaries(), and GETChannel::OutSample().

int GETActarTpc::GetSignalBoundaries ( double &  xmin, double &  xmax, double &  ymin, double &  ymax  )

virtual

Function returning the X and Y boundaries of the signal. The boundaries are expressed in terms of physical units (corresponding to bin center).

The function returns the number of channels for which the signal is over the threshold.

Parameters

xmin	lower value on X axis
xmax	upper value on X axis
ymin	lower value on Y axis
ymax	upper value on Y axis

References GetSignalBoundaries().

GETActarTpc::GObject ( GETActarTpc  )

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.

int GETActarTpc::Init ( u_int  nx, u_int  ny, u_int  n, double  dt  )

virtual

This function is redefined from the base class (GETSystem) in order to adapt the look-up table and the hit mask to the pads number.

Parameters

nx	number pads along X direction
ny	number pads along Y direction
n	dimension of data samples
dt	sampling period (us)

References GETSystem::cobo, GETSystem::cobo_number, GETCoBo::GetChildrenNumber(), GETObject::GetFullId(), GETSystem::Init(), GETSystem::lookup_table, GETLookupTable::SetDefaultTable(), and SetHitMask().

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

GETHitMask * GETActarTpc::SetHitMask ( GETHitMaskXY *  mask )

virtual

This function is redefined from the base class (GETSystem) in order to force the hit mask to derive from GETHitMaskXY class.

Parameters

mask	pointer to the hit mask

References GETSystem::hit_mask, pad_mask, GETHitMask::SetDataInfo(), GETSystem::SetHitMask(), and GET::signalOut.

Referenced by Init().

---

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

• GETActarTpc.hh
• GETActarTpc.cpp
• GETActarTpc.icc