GETRunMean.cpp File Reference

#include "GETRunMean.hh"

Functions
int	GETRunAsAdMean (GETSystem &get, const string runfile, u_int *ndat, u_int nmax)
int	GETRunAsAdRMS (GETSystem &get, const string runfile, u_int *ndat, u_int nmax, bool same)
int	GETRunHitChannelMean (GETSystem &get, const string runfile, u_int *ndat, u_int nmax)
int	GETRunHitChannelRMS (GETSystem &get, const string runfile, u_int *ndat, u_int nmax, bool same)
int	GETSystemMean (GETSystem &get, const string &data_file, int nmax, bool outcorr)
int	GETSystemMean (GETSystem &get, const GStringList &file_list, int nmax, bool outcorr)
int	GETSystemMeanPower (GETSystem &get, const string &data_file, int nmax, bool outcorr)
int	GETSystemMeanPower (GETSystem &get, const GStringList &file_list, int nmax, bool outcorr)
int	GETSystemStdDeviation (GETSystem &get, const string &data_file, int nmax, bool outcorr, bool same)
int	GETSystemStdDeviation (GETSystem &get, const GStringList &file_list, int nmax, bool outcorr, bool same)

Variables
u_int	getEventCountInfo = 10

Detailed Description

Source file for functions related to the averaging of runs events.

Function Documentation

int GETRunAsAdMean	(	GETSystem &	get,
		const string	runfile,
		u_int *	ndat,
		u_int	nmax
	)

Function reading a run file, and summing signals from all events in order to compute the average, that is stored in the output samples of the GET system channels.

This function works also for non merged CoBo (AsAd) frames, since it counts frames individually for each AsAd.

If the GET system analyser is defined and some data checks are set, only events with no problems are processed.

The function returns the number of frames read, or a negative value in case of problem.

Parameters

get	GET system object
runfile	run file pattern
ndat	if not NULL, return the number of frames for each AsAd
nmax	maximum number of events to read (0 for all)

References AGET_SIZE, ASAD_SIZE, GETSystemAnalyser::BadChannelCount(), COBO_SIZE, and getEventCountInfo.

int GETRunAsAdRMS	(	GETSystem &	get,
		const string	runfile,
		u_int *	ndat,
		u_int	nmax,
		bool	same
	)

Function reading a run file, and computing the standard deviation from all events compared to the (average) samples initially stored in the output samples of the GET system channels.

This function works also for non merged CoBo (AsAd) frames, since it counts frames individually for each AsAd.

If the GET system analyser is defined and some data checks are set, only events with no problems are processed.

The resulting RMS samples are then stored in the output samples of the GET system channels, replacing the average samples. The function returns the number of frames read, or a negative value in case of problem.

Parameters

get	GET system object
runfile	run file pattern
nmax	maximum number of events to read (0 for all)
ndat	if not NULL, return the number of frames for each AsAd
same	whether the RMS is computed from same data than the average (then the sum is divided by N-1 instead of N)

References AGET_SIZE, ASAD_SIZE, GETSystemAnalyser::BadChannelCount(), COBO_SIZE, and getEventCountInfo.

int GETRunHitChannelMean	(	GETSystem &	get,
		const string	runfile,
		u_int *	ndat,
		u_int	nmax
	)

Function reading a run file, and summing signals from all events in order to compute the average, that is stored in the output samples of the GET system channels.

This function works also for non merged CoBo (AsAd) frames, and computes the number of events for each individual channel.

If the analyser is defined, the data corrections apply, and if the hit-mask is defined, only hit channels are counted in the average.

The function returns the number of frames read, or a negative value in case of problem.

Parameters

get	GET system object
runfile	run file pattern
ndat	if not NULL, return the number of events for each channel
nmax	maximum number of events to read (0 for all)

References AGET_SIZE, ASAD_SIZE, COBO_SIZE, and getEventCountInfo.

int GETRunHitChannelRMS	(	GETSystem &	get,
		const string	runfile,
		u_int *	ndat,
		u_int	nmax,
		bool	same
	)

Function reading a run file, and computing the standard deviation from all events compared to the (average) samples initially stored in the output samples of the GET system channels.

This function works also for non merged CoBo (AsAd) frames, and computes the number of events for each individual channel.

If the analyser is defined, the data corrections apply, and if the hit-mask is defined, only hit channels are counted in the average.

The resulting RMS samples are then stored in the output samples of the GET system channels, replacing the average samples. The function returns the number of frames read, or a negative value in case of problem.

Parameters

get	GET system object
runfile	run file pattern
nmax	maximum number of events to read (0 for all)
ndat	if not NULL, return the number of events for each channel
same	whether the RMS is computed from same data than the average (then the sum is divided by N-1 instead of N)

References AGET_SIZE, ASAD_SIZE, COBO_SIZE, and getEventCountInfo.

int GETSystemMean	(	GETSystem &	get,
		const string &	data_file,
		int	nmax,
		bool	outcorr
	)

This function reads events for the GET system, and computes the average of the (output) samples. The mean signals are stored in the argument get object. The function returns the effective number of events that have been read.

Parameters

get	GET system to store average signals
data_file	events run file
nmax	number of events to read (0 for all)
outcorr	whether to apply output correction process to each event (for example baseline process), if defined

Examples:

Demonstrator_Noise.C, and Demonstrator_RMS2.C.

References GETSystemMean().

Referenced by GETRunMean(), and GETSystemMean().

int GETSystemMean	(	GETSystem &	get,
		const GStringList &	file_list,
		int	nmax,
		bool	outcorr
	)

This function reads events for the GET system, and computes the average of the (output) samples. The mean signals are stored in the argument get object. The function returns the effective number of events that have been read.

Parameters

get	GET system to store average signals
file_list	list of events run files names
nmax	number of events to read (0 for all)
outcorr	whether to apply output correction process to each event (for example baseline process), if defined

References GETChannel::ApplyOutputCorrection(), GETSystemAnalyser::BadChannelCount(), getEventCountInfo, GETObject::GetTotalChannel(), and GETChannel::OutSample().

int GETSystemMeanPower	(	GETSystem &	get,
		const string &	data_file,
		int	nmax,
		bool	outcorr
	)

This function reads events for the GET system, and computes the average spectral power of the (output) samples. The mean powers are stored in the argument get object. The macro returns the effective number of events that have been read.

Parameters

get	GET system to store average signals
data_file	events run file
nmax	number of events to read (0 for all)
outcorr	whether to apply output correction process to each event (for example baseline process), if defined

References GETSystemMeanPower().

Referenced by GETSystemMeanPower().

int GETSystemMeanPower	(	GETSystem &	get,
		const GStringList &	file_list,
		int	nmax,
		bool	outcorr
	)

This function reads events for the GET system, and computes the average spectral power of the (output) samples. The mean powers are stored in the argument get object. The macro returns the effective number of events that have been read.

Parameters

get	GET system to store average signals
file_list	list of events run files names
nmax	number of events to read (0 for all)
outcorr	whether to apply output correction process to each event (for example baseline process), if defined

References GETChannel::ApplyOutputCorrection(), GETSystemAnalyser::BadChannelCount(), getEventCountInfo, GETObject::GetTotalChannel(), and GETChannel::OutSample().

int GETSystemStdDeviation	(	GETSystem &	get,
		const string &	data_file,
		int	nmax,
		bool	outcorr,
		bool	same
	)

This function reads events for the GET system, and computes the standard deviation of the (output) samples, with respect to the initial content of the channels of the reduced CoBo argument. The initial content of the output channels should be the signal average.

The sum of the squared difference is divided by (N-1) where N is the number of events, assuming the RMS samples are computed with the same events than the mean samples.

The RMS signals are stored in the argument get object. The macro returns the effective number of events that have been read.

Parameters

get	GET system with mean output samples at function call and standard deviation at function return
data_file	events run file
nmax	number of events to read (0 for all)
outcorr	whether to apply output correction process to each event (for example baseline process), if defined
same	whether the RMS is computed from same data than the average (then the sum is divided by N-1 instead of N)

Examples:

Demonstrator_Noise.C, and Demonstrator_RMS2.C.

References GETSystemStdDeviation().

Referenced by GETRunRMS(), and GETSystemStdDeviation().

int GETSystemStdDeviation	(	GETSystem &	get,
		const GStringList &	file_list,
		int	nmax,
		bool	outcorr,
		bool	same
	)

This function reads events for the GET system, and computes the standard deviation of the (output) samples, with respect to the initial content of the channels of the reduced CoBo argument. The initial content of the output channels should be the signal average.

The sum of the squared difference is divided by (N-1) where N is the number of events, assuming the RMS samples are computed with the same events than the mean samples.

The RMS signals are stored in the argument get object. The macro returns the effective number of events that have been read.

Parameters

get	GET system with mean output samples at function call and standard deviation at function return
file_list	list of events run files names
nmax	number of events to read (0 for all)
outcorr	whether to apply output correction process to each event (for example baseline process), if defined
same	whether the RMS is computed from same data than the average (then the sum is divided by N-1 instead of N)

References GETChannel::ApplyOutputCorrection(), GETSystemAnalyser::BadChannelCount(), getEventCountInfo, GETObject::GetTotalChannel(), and GETChannel::OutSample().

Variable Documentation

u_int getEventCountInfo = 10

Information frequency when processing events.

Referenced by GETRunAsAdMean(), GETRunAsAdRMS(), GETRunHitChannelMean(), GETRunHitChannelRMS(), GETSystemMean(), GETSystemMeanPower(), and GETSystemStdDeviation().