GWOLLUM  4.2.0
Tools for gravitational-wave analyses
TriggerSelect Class Reference

Select trigger parameters. More...

#include <TriggerSelect.h>

Public Member Functions

int GetClusterTag (void)
 Returns the cluster tag used for the selection. More...
 
double GetFrequencyMax (void)
 Returns the maximal frequency value. More...
 
double GetFrequencyMin (void)
 Returns the minimal frequency value. More...
 
double GetFrequencyRange (void)
 Returns the frequency range value. More...
 
unsigned int GetFrequencyResolution (void)
 Returns the frequency resolution value. More...
 
double GetQMax (void)
 Returns the maximal Q value. More...
 
double GetQMin (void)
 Returns the minimal Q value. More...
 
double GetQRange (void)
 Returns the Q range value. More...
 
unsigned int GetQResolution (void)
 Returns the Q resolution value. More...
 
double GetSnrMax (void)
 Returns the maximal SNR value. More...
 
double GetSnrMin (void)
 Returns the minimal SNR value. More...
 
double GetSnrRange (void)
 Returns the SNR range value. More...
 
unsigned int GetSnrResolution (void)
 Returns the SNR resolution value. More...
 
TH1D * GetTH1D (const string aParameter)
 Returns an empty 1-D histogram binned in a given parameter. More...
 
TH2D * GetTH2D (const string aParameterX, const string aParameterY)
 Returns an empty 2-D histogram binned in a given combination of parameters. More...
 
double GetTimeMax (void)
 Returns the maximal time value. More...
 
double GetTimeMin (void)
 Returns the minimal time value. More...
 
double GetTimeRange (void)
 Returns the time range value. More...
 
unsigned int GetTimeResolution (void)
 Returns the time resolution value. More...
 
string GetTimeStamp (void)
 Returns the time stamp for this selection. More...
 
void PrintSelection (void)
 Prints the current selection in the standard output. More...
 
void ResetSelection (void)
 Resets the selection back to default. More...
 
void SetFrequencyMax (const double aMax)
 Sets the maximal frequency value. More...
 
void SetFrequencyMin (const double aMin)
 Sets the minimal frequency value. More...
 
void SetFrequencyRange (const double aMin, const double aMax)
 Sets the frequency range. More...
 
void SetFrequencyResolution (const unsigned int aResolution)
 Sets the frequency resolution. More...
 
void SetFrequencySelection (const unsigned int aResolution, const double aMin, const double aMax)
 Sets the frequency selection. More...
 
void SetQMax (const double aMax)
 Sets the maximal Q value. More...
 
void SetQMin (const double aMin)
 Sets the minimal Q value. More...
 
void SetQRange (const double aMin, const double aMax)
 Sets the Q range. More...
 
void SetQResolution (const unsigned int aResolution)
 Sets the Q resolution. More...
 
void SetQSelection (const unsigned int aResolution, const double aMin, const double aMax)
 Sets the Q selection. More...
 
void SetSnrMax (const double aMax)
 Sets the maximal SNR value. More...
 
void SetSnrMin (const double aMin)
 Sets the minimal SNR value. More...
 
void SetSnrRange (const double aMin, const double aMax)
 Sets the SNR range. More...
 
void SetSnrResolution (const unsigned int aResolution)
 Sets the SNR resolution. More...
 
void SetSnrSelection (const unsigned int aResolution, const double aMin, const double aMax)
 Sets the SNR selection. More...
 
void SetTimeMax (const double aMax)
 Sets the maximal time value. More...
 
void SetTimeMin (const double aMin)
 Sets the minimal time value. More...
 
void SetTimeRange (const double aMin, const double aMax)
 Sets the time range. More...
 
void SetTimeResolution (const unsigned int aResolution)
 Sets the time resolution. More...
 
void SetTimeSelection (const unsigned int aResolution, const double aMin, const double aMax)
 Sets the time selection. More...
 
void UseClusterTag (unsigned int aTag)
 Use cluster tags. More...
 
void UseDateTime (void)
 Use a date format for time axes. More...
 
void UseGpsTime (void)
 Use a GPS format for time axes. More...
 
void UseTriggers (void)
 Use triggers. More...
 
Constructors and destructors
 TriggerSelect (const string aName, const unsigned int aVerbose=0)
 Constructor of the TriggerSelect class. More...
 
 TriggerSelect (ReadTriggers *aTriggers, const unsigned int aVerbose=0)
 Constructor of the TriggerSelect class. More...
 
virtual ~TriggerSelect (void)
 Destructor of the TriggerSelect class. More...
 

Private Member Functions

void MakeFbins (void)
 Makes frequency binning (log). More...
 
void MakeQbins (void)
 Makes Q binning (log). More...
 
void MakeSbins (void)
 Makes SNR binning (log). More...
 
void MakeTbins (void)
 Makes time binning (linear). More...
 

Private Attributes

int clustertag
 cluster tag: -1 for triggers. More...
 
double * fbins
 Frequency bins. More...
 
double fmax
 Frequency max (current). More...
 
double fmax_0
 Frequency max (default). More...
 
double fmin
 Frequency min (current). More...
 
double fmin_0
 Frequency min (default). More...
 
string name
 Name. More...
 
unsigned int nfbins
 Number of frequency bins (current). More...
 
unsigned int nfbins_0
 Number of frequency bins (default). More...
 
unsigned int nqbins
 Number of Q bins (current). More...
 
unsigned int nqbins_0
 Number of Q bins (default). More...
 
unsigned int nsbins
 Number of SNR bins (current). More...
 
unsigned int nsbins_0
 Number of SNR bins (default). More...
 
unsigned int ntbins
 Number of time bins (current). More...
 
unsigned int ntbins_0
 Number of time bins (default). More...
 
double * qbins
 Q bins. More...
 
double qmax
 Q max (current). More...
 
double qmax_0
 Q max (default). More...
 
double qmin
 Q min (current). More...
 
double qmin_0
 Q min (default). More...
 
double * sbins
 SNR bins. More...
 
double smax
 SNR max (current). More...
 
double smax_0
 SNR max (default). More...
 
double smin
 SNR min (current). More...
 
double smin_0
 SNR min (default). More...
 
string sstart
 Start time string. See MakeTbins(). More...
 
double * tbins
 Time bins. More...
 
double tmax
 Time max (current). More...
 
double tmax_0
 Time max (default). More...
 
double tmin
 Time min (current). More...
 
double tmin_0
 Time min (default). More...
 
bool usedate
 Flag to use a date format. More...
 
unsigned int verbose
 Verbosity level. More...
 

Detailed Description

Select trigger parameters.

This class is designed to operate a selection over trigger parameters: time, frequency, Q and SNR. For each parameter, the user can select a minimum, a maximum and a resolution. The resolution is the number of bins to cover the parameter range. The time is linearly binned while the other parameters are logarithmically binned. Once a selection is defined, pre-binned histograms can be extracted.

Author
Florent Robinet

Constructor & Destructor Documentation

◆ TriggerSelect() [1/2]

TriggerSelect::TriggerSelect ( const string  aName,
const unsigned int  aVerbose = 0 
)

Constructor of the TriggerSelect class.

Single-bin selections.

Parameters
[in]aNameSelection name.
[in]aVerboseVerbosity level.

◆ TriggerSelect() [2/2]

TriggerSelect::TriggerSelect ( ReadTriggers aTriggers,
const unsigned int  aVerbose = 0 
)

Constructor of the TriggerSelect class.

The default selection is defined using the metadata (min/max) of the input ReadTriggers object. For each parameter the resolution is set to 1 bin. The selection is given the input Streams name.

Parameters
[in]aTriggersInput triggers.
[in]aVerboseVerbosity level.

◆ ~TriggerSelect()

TriggerSelect::~TriggerSelect ( void  )
virtual

Destructor of the TriggerSelect class.

Member Function Documentation

◆ GetClusterTag()

int TriggerSelect::GetClusterTag ( void  )
inline

Returns the cluster tag used for the selection.

Returns
-1 if triggers are used.

◆ GetFrequencyMax()

double TriggerSelect::GetFrequencyMax ( void  )
inline

Returns the maximal frequency value.

◆ GetFrequencyMin()

double TriggerSelect::GetFrequencyMin ( void  )
inline

Returns the minimal frequency value.

◆ GetFrequencyRange()

double TriggerSelect::GetFrequencyRange ( void  )
inline

Returns the frequency range value.

◆ GetFrequencyResolution()

unsigned int TriggerSelect::GetFrequencyResolution ( void  )
inline

Returns the frequency resolution value.

◆ GetQMax()

double TriggerSelect::GetQMax ( void  )
inline

Returns the maximal Q value.

◆ GetQMin()

double TriggerSelect::GetQMin ( void  )
inline

Returns the minimal Q value.

◆ GetQRange()

double TriggerSelect::GetQRange ( void  )
inline

Returns the Q range value.

◆ GetQResolution()

unsigned int TriggerSelect::GetQResolution ( void  )
inline

Returns the Q resolution value.

◆ GetSnrMax()

double TriggerSelect::GetSnrMax ( void  )
inline

Returns the maximal SNR value.

◆ GetSnrMin()

double TriggerSelect::GetSnrMin ( void  )
inline

Returns the minimal SNR value.

◆ GetSnrRange()

double TriggerSelect::GetSnrRange ( void  )
inline

Returns the SNR range value.

◆ GetSnrResolution()

unsigned int TriggerSelect::GetSnrResolution ( void  )
inline

Returns the SNR resolution value.

◆ GetTH1D()

TH1D * TriggerSelect::GetTH1D ( const string  aParameter)

Returns an empty 1-D histogram binned in a given parameter.

  • "Time",
  • "Frequency",
  • "Q",
  • "SNR".
Note
The user must delete the returned histogram.
Parameters
[in]aParameterParameter name.

◆ GetTH2D()

TH2D * TriggerSelect::GetTH2D ( const string  aParameterX,
const string  aParameterY 
)

Returns an empty 2-D histogram binned in a given combination of parameters.

  • "Time",
  • "Frequency",
  • "Q",
  • "SNR".
Note
The user must delete the returned histogram.
Parameters
[in]aParameterXParameter name for X axis.
[in]aParameterYParameter name for Y axis.

◆ GetTimeMax()

double TriggerSelect::GetTimeMax ( void  )
inline

Returns the maximal time value.

◆ GetTimeMin()

double TriggerSelect::GetTimeMin ( void  )
inline

Returns the minimal time value.

◆ GetTimeRange()

double TriggerSelect::GetTimeRange ( void  )
inline

Returns the time range value.

◆ GetTimeResolution()

unsigned int TriggerSelect::GetTimeResolution ( void  )
inline

Returns the time resolution value.

◆ GetTimeStamp()

string TriggerSelect::GetTimeStamp ( void  )
inline

Returns the time stamp for this selection.

The minimum time for this selection is returned.

Returns
A date is returned if UseDateTime() was called, a GPS time is returned otherwise.

◆ MakeFbins()

void TriggerSelect::MakeFbins ( void  )
private

Makes frequency binning (log).

◆ MakeQbins()

void TriggerSelect::MakeQbins ( void  )
private

Makes Q binning (log).

◆ MakeSbins()

void TriggerSelect::MakeSbins ( void  )
private

Makes SNR binning (log).

◆ MakeTbins()

void TriggerSelect::MakeTbins ( void  )
private

Makes time binning (linear).

◆ PrintSelection()

void TriggerSelect::PrintSelection ( void  )

Prints the current selection in the standard output.

◆ ResetSelection()

void TriggerSelect::ResetSelection ( void  )

Resets the selection back to default.

◆ SetFrequencyMax()

void TriggerSelect::SetFrequencyMax ( const double  aMax)
inline

Sets the maximal frequency value.

Parameters
[in]aMaxMaximal value.

◆ SetFrequencyMin()

void TriggerSelect::SetFrequencyMin ( const double  aMin)
inline

Sets the minimal frequency value.

Parameters
[in]aMinMinimal value.

◆ SetFrequencyRange()

void TriggerSelect::SetFrequencyRange ( const double  aMin,
const double  aMax 
)
inline

Sets the frequency range.

Parameters
[in]aMinMinimal value.
[in]aMaxMaximal value.

◆ SetFrequencyResolution()

void TriggerSelect::SetFrequencyResolution ( const unsigned int  aResolution)
inline

Sets the frequency resolution.

Parameters
[in]aResolutionResolution (number of bins).

◆ SetFrequencySelection()

void TriggerSelect::SetFrequencySelection ( const unsigned int  aResolution,
const double  aMin,
const double  aMax 
)

Sets the frequency selection.

Parameters
[in]aResolutionResolution (number of bins).
[in]aMinMinimal value.
[in]aMaxMaximal value.

◆ SetQMax()

void TriggerSelect::SetQMax ( const double  aMax)
inline

Sets the maximal Q value.

Parameters
[in]aMaxMaximal value.

◆ SetQMin()

void TriggerSelect::SetQMin ( const double  aMin)
inline

Sets the minimal Q value.

Parameters
[in]aMinMinimal value.

◆ SetQRange()

void TriggerSelect::SetQRange ( const double  aMin,
const double  aMax 
)
inline

Sets the Q range.

Parameters
[in]aMinMinimal value.
[in]aMaxMaximal value.

◆ SetQResolution()

void TriggerSelect::SetQResolution ( const unsigned int  aResolution)
inline

Sets the Q resolution.

Parameters
[in]aResolutionResolution (number of bins).

◆ SetQSelection()

void TriggerSelect::SetQSelection ( const unsigned int  aResolution,
const double  aMin,
const double  aMax 
)

Sets the Q selection.

Parameters
[in]aResolutionResolution (number of bins).
[in]aMinMinimal value.
[in]aMaxMaximal value.

◆ SetSnrMax()

void TriggerSelect::SetSnrMax ( const double  aMax)
inline

Sets the maximal SNR value.

Parameters
[in]aMaxMaximal value.

◆ SetSnrMin()

void TriggerSelect::SetSnrMin ( const double  aMin)
inline

Sets the minimal SNR value.

Parameters
[in]aMinMinimal value.

◆ SetSnrRange()

void TriggerSelect::SetSnrRange ( const double  aMin,
const double  aMax 
)
inline

Sets the SNR range.

Parameters
[in]aMinMinimal value.
[in]aMaxMaximal value.

◆ SetSnrResolution()

void TriggerSelect::SetSnrResolution ( const unsigned int  aResolution)
inline

Sets the SNR resolution.

Parameters
[in]aResolutionResolution (number of bins).

◆ SetSnrSelection()

void TriggerSelect::SetSnrSelection ( const unsigned int  aResolution,
const double  aMin,
const double  aMax 
)

Sets the SNR selection.

Parameters
[in]aResolutionResolution (number of bins).
[in]aMinMinimal value.
[in]aMaxMaximal value.

◆ SetTimeMax()

void TriggerSelect::SetTimeMax ( const double  aMax)
inline

Sets the maximal time value.

Parameters
[in]aMaxMaximal value.

◆ SetTimeMin()

void TriggerSelect::SetTimeMin ( const double  aMin)
inline

Sets the minimal time value.

Parameters
[in]aMinMinimal value.

◆ SetTimeRange()

void TriggerSelect::SetTimeRange ( const double  aMin,
const double  aMax 
)
inline

Sets the time range.

Parameters
[in]aMinMinimal value.
[in]aMaxMaximal value.

◆ SetTimeResolution()

void TriggerSelect::SetTimeResolution ( const unsigned int  aResolution)
inline

Sets the time resolution.

Parameters
[in]aResolutionResolution (number of bins).

◆ SetTimeSelection()

void TriggerSelect::SetTimeSelection ( const unsigned int  aResolution,
const double  aMin,
const double  aMax 
)

Sets the time selection.

Parameters
[in]aResolutionResolution (number of bins).
[in]aMinMinimal value.
[in]aMaxMaximal value.

◆ UseClusterTag()

void TriggerSelect::UseClusterTag ( unsigned int  aTag)
inline

Use cluster tags.

Warning
Only positive tags can be considered.
Parameters
[in]aTagCluster tag.

◆ UseDateTime()

void TriggerSelect::UseDateTime ( void  )
inline

Use a date format for time axes.

◆ UseGpsTime()

void TriggerSelect::UseGpsTime ( void  )
inline

Use a GPS format for time axes.

◆ UseTriggers()

void TriggerSelect::UseTriggers ( void  )
inline

Use triggers.

Member Data Documentation

◆ clustertag

int TriggerSelect::clustertag
private

cluster tag: -1 for triggers.

◆ fbins

double* TriggerSelect::fbins
private

Frequency bins.

◆ fmax

double TriggerSelect::fmax
private

Frequency max (current).

◆ fmax_0

double TriggerSelect::fmax_0
private

Frequency max (default).

◆ fmin

double TriggerSelect::fmin
private

Frequency min (current).

◆ fmin_0

double TriggerSelect::fmin_0
private

Frequency min (default).

◆ name

string TriggerSelect::name
private

Name.

◆ nfbins

unsigned int TriggerSelect::nfbins
private

Number of frequency bins (current).

◆ nfbins_0

unsigned int TriggerSelect::nfbins_0
private

Number of frequency bins (default).

◆ nqbins

unsigned int TriggerSelect::nqbins
private

Number of Q bins (current).

◆ nqbins_0

unsigned int TriggerSelect::nqbins_0
private

Number of Q bins (default).

◆ nsbins

unsigned int TriggerSelect::nsbins
private

Number of SNR bins (current).

◆ nsbins_0

unsigned int TriggerSelect::nsbins_0
private

Number of SNR bins (default).

◆ ntbins

unsigned int TriggerSelect::ntbins
private

Number of time bins (current).

◆ ntbins_0

unsigned int TriggerSelect::ntbins_0
private

Number of time bins (default).

◆ qbins

double* TriggerSelect::qbins
private

Q bins.

◆ qmax

double TriggerSelect::qmax
private

Q max (current).

◆ qmax_0

double TriggerSelect::qmax_0
private

Q max (default).

◆ qmin

double TriggerSelect::qmin
private

Q min (current).

◆ qmin_0

double TriggerSelect::qmin_0
private

Q min (default).

◆ sbins

double* TriggerSelect::sbins
private

SNR bins.

◆ smax

double TriggerSelect::smax
private

SNR max (current).

◆ smax_0

double TriggerSelect::smax_0
private

SNR max (default).

◆ smin

double TriggerSelect::smin
private

SNR min (current).

◆ smin_0

double TriggerSelect::smin_0
private

SNR min (default).

◆ sstart

string TriggerSelect::sstart
private

Start time string. See MakeTbins().

◆ tbins

double* TriggerSelect::tbins
private

Time bins.

◆ tmax

double TriggerSelect::tmax
private

Time max (current).

◆ tmax_0

double TriggerSelect::tmax_0
private

Time max (default).

◆ tmin

double TriggerSelect::tmin
private

Time min (current).

◆ tmin_0

double TriggerSelect::tmin_0
private

Time min (default).

◆ usedate

bool TriggerSelect::usedate
private

Flag to use a date format.

◆ verbose

unsigned int TriggerSelect::verbose
private

Verbosity level.


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