Classes | Public Member Functions | Static Public Member Functions | Public Attributes | Static Public Attributes | List of all members
AnitaEventSummary Class Reference

Common analysis format between UCorrelator and Acclaim. More...

#include <AnitaEventSummary.h>

Classes

class  ChannelInfo
 
class  EventFlags
 
class  MCTruth
 
class  PayloadLocation
 
class  PointingHypothesis
 
class  SourceHypothesis
 
class  WaveformInfo
 Stores information about a coherently summed waveform (filtered/unfiltered/deconvolved) The coherent summing of the waveform corresponds to a direction stored in a PointingHypothesis Units are assumed to be in mV, ns,and GHz. More...
 

Public Member Functions

 AnitaEventSummary ()
 Reduced GPS data. More...
 
 AnitaEventSummary (const RawAnitaHeader *header)
 Constructor. More...
 
 AnitaEventSummary (const RawAnitaHeader *header, UsefulAdu5Pat *pat, const TruthAnitaEvent *truth=0)
 Constructor. More...
 
void setTriggerInfomation (const RawAnitaHeader *header)
 
void setSourceInformation (UsefulAdu5Pat *pat, const TruthAnitaEvent *truth=0)
 
void zeroInternals ()
 
Bool_t update () const
 
AnitaPol::AnitaPol_t highestPol () const
 
Int_t highestPolAsInt () const
 
Int_t highestPeakInd () const
 
const PointingHypothesishighestPeak () const
 
const WaveformInfohighestCoherent () const
 
const WaveformInfohighestDeconvolved () const
 
const WaveformInfohighestCoherentFiltered () const
 
const WaveformInfohighestDeconvolvedFiltered () const
 
AnitaPol::AnitaPol_t mostImpulsivePol (int whichMetric=0) const
 
Int_t mostImpulsivePolAsInt (int whichMetric=0) const
 
Int_t mostImpulsiveInd (int whichMetric=0) const
 
const PointingHypothesismostImpulsivePeak (int whichMetric=0) const
 
const WaveformInfomostImpulsiveCoherent (int whichMetric=0) const
 
const WaveformInfomostImpulsiveDeconvolved (int whichMetric=0) const
 
const WaveformInfomostImpulsiveCoherentFiltered (int whichMetric=0) const
 
const WaveformInfomostImpulsiveDeconvolvedFiltered (int whichMetric=0) const
 
Double_t weight ()
 
AnitaPol::AnitaPol_t trainingPol () const
 Return the weight of the event, always returns 1 for data, the weight from MCTruth otherwise. More...
 
Int_t trainingPolAsInt () const
 
Int_t trainingPeakInd () const
 
const PointingHypothesistrainingPeak () const
 
const WaveformInfotrainingCoherent () const
 
const WaveformInfotrainingDeconvolved () const
 
const WaveformInfotrainingCoherentFiltered () const
 
const WaveformInfotrainingDeconvolvedFiltered () const
 
Int_t countChannelAboveThreshold (int threshold=100) const
 

Static Public Member Functions

static void setThresholdForMostImpulsive (double threshold)
 
static void useProbWeight (int use)
 value between 0 and 1, will find the brightest peak that is within threshold as impulsive as the most impulsive peak
 

Public Attributes

Int_t run
 
UInt_t eventNumber
 Run.
 
UInt_t realTime
 Event number.
 
Int_t nPeaks [AnitaPol::kNotAPol]
 Time of the event.
 
PointingHypothesis peak [AnitaPol::kNotAPol][maxDirectionsPerPol]
 Number of peaks stored in this AnitaEventSummary (might be less than maxDirectionsPerPol)
 
WaveformInfo coherent [AnitaPol::kNotAPol][maxDirectionsPerPol]
 Summaries of the event peak directions (indices of all WaveformInfo member arrays match peak index)
 
WaveformInfo deconvolved [AnitaPol::kNotAPol][maxDirectionsPerPol]
 Summaries of the (unfiltered) coherently summed waveforms, array index correponds to entry in peak[][].
 
WaveformInfo coherent_filtered [AnitaPol::kNotAPol][maxDirectionsPerPol]
 Summaries of the (unfiltered) de-dispersed coherently summed waveforms, array index correponds to entry in peak[][].
 
WaveformInfo deconvolved_filtered [AnitaPol::kNotAPol][maxDirectionsPerPol]
 Summaries of the filtered, coherently summed waveforms, array index correponds to entry in peak[][].
 
ChannelInfo channels [AnitaPol::kNotAPol][NUM_SEAVEYS]
 Summaries of the filtered, de-dispersed, coherently summed waveforms, array index correponds to entry in peak[][].
 
EventFlags flags
 Summaries of each channel's waveform.
 
SourceHypothesis sun
 Flags corresponding the event quality, trigger type, calibration pulser timing, etc.
 
SourceHypothesis wais
 Contains location of sun in map coordinates at time of event.
 
SourceHypothesis ldb
 Contains location of WAIS divide cal pulser in map coordinates at time of event.
 
MCTruth mc
 Contains location of LDB cal pulser in map coordinates at time of event.
 
PayloadLocation anitaLocation
 Contains summary information about MC truth, if real data then this filled with constant, unphysical values.
 

Static Public Attributes

static const Int_t maxDirectionsPerPol = 5
 
static const Int_t peaksPerSpectrum = 3
 The maximum number of hypotheses storable per polarization */.
 
static const Int_t numFracPowerWindows = 5
 The maximum number of frequency peaks per waveform spectrum.
 
static const Int_t numBlastPowerBands = 3
 

Detailed Description

Common analysis format between UCorrelator and Acclaim.

Two independent analyses will fill most of the variables in these trees. Needless to say, there's no guarantee that everything will be filled, so be wary if something is 0 (it may not have been filled). Also, member variables that have been filled may have slightly different definitions between analyses. You have been warned.

This class and its subclasses have utility functions that can be used inside TTree::Draw(). For example, with a TTree (called sumTree) of AnitaEventSummaries (called sum) doing

sumTree->Draw("sum.highestPeak().dPhiWais()")

Should produce a histogram of the reconstructed phi-angle from the WAIS divide cal pulser.

Definition at line 32 of file AnitaEventSummary.h.

Inheritance diagram for AnitaEventSummary:
Inheritance graph
[legend]
Collaboration diagram for AnitaEventSummary:
Collaboration graph
[legend]

Constructor & Destructor Documentation

AnitaEventSummary::AnitaEventSummary ( )

Reduced GPS data.

Default Constructor.

Default constructor for ROOT

Definition at line 33 of file AnitaEventSummary.cc.

AnitaEventSummary::AnitaEventSummary ( const RawAnitaHeader header)

Constructor.

Takes care of copying the header info into the event summary

Definition at line 48 of file AnitaEventSummary.cc.

AnitaEventSummary::AnitaEventSummary ( const RawAnitaHeader header,
UsefulAdu5Pat pat,
const TruthAnitaEvent truth = 0 
)

Constructor.

Takes care of copying the header and GPS info into the event summary

Definition at line 70 of file AnitaEventSummary.cc.

Member Function Documentation

int AnitaEventSummary::countChannelAboveThreshold ( int  threshold = 100) const

Utility function to get the number of the channel that rms > threshold Useful for finding the blast events

Returns
the the number of the channel that rms > threshold

Definition at line 349 of file AnitaEventSummary.cc.

const AnitaEventSummary::WaveformInfo & AnitaEventSummary::highestCoherent ( ) const

Utility function to return a const reference to the the unfiltered coherently summed waveform info of the polarisation of the highest map peak Useful for TTree::Draw()

Returns
the unfiltered coherently summed waveform info corresponding to the highest map peak

Definition at line 185 of file AnitaEventSummary.cc.

const AnitaEventSummary::WaveformInfo & AnitaEventSummary::highestCoherentFiltered ( ) const

Utility function to return a const reference to the the filtered coherently summed waveform info of the polarisation of the highest map peak Useful for TTree::Draw()

Returns
the filtered coherently summed waveform info corresponding to the highest map peak

Definition at line 211 of file AnitaEventSummary.cc.

const AnitaEventSummary::WaveformInfo & AnitaEventSummary::highestDeconvolved ( ) const

Utility function to return a const reference to the the unfiltered, deconvolved coherently summed waveform info of the polarisation of the highest map peak Useful for TTree::Draw()

Returns
the unfiltered, deconvolved coherently summed waveform info corresponding to the highest map peak

Definition at line 197 of file AnitaEventSummary.cc.

const AnitaEventSummary::WaveformInfo & AnitaEventSummary::highestDeconvolvedFiltered ( ) const

Utility function to return a const reference to the the filtered, deconvolved coherently summed waveform info of the polarisation of the highest map peak Useful for TTree::Draw()

Returns
the filtered, deconvolved coherently summed waveform info corresponding to the highest map peak

Definition at line 223 of file AnitaEventSummary.cc.

const AnitaEventSummary::PointingHypothesis & AnitaEventSummary::highestPeak ( ) const

Utility function to return a const reference to the higher map peak. Useful for TTree::Draw()

Returns
the peak with largest value

Definition at line 173 of file AnitaEventSummary.cc.

int AnitaEventSummary::highestPeakInd ( ) const

Utility function to get the index of the highest map peak Useful for TTree::Draw()

Returns
the index of the largest interferometric map peak

Definition at line 160 of file AnitaEventSummary.cc.

AnitaPol::AnitaPol_t AnitaEventSummary::highestPol ( ) const

Utility function to get the polarisation of the highest map peak Useful for TTree::Draw()

Returns
the polarisation of the largest interferometric map peak

Definition at line 136 of file AnitaEventSummary.cc.

int AnitaEventSummary::highestPolAsInt ( ) const

Utility function to get the polarisation of the highest map peak Useful for TTree::Draw()

Returns
the polarisation of the largest interferometric map peak

Definition at line 148 of file AnitaEventSummary.cc.

const AnitaEventSummary::WaveformInfo & AnitaEventSummary::mostImpulsiveCoherent ( int  whichMetric = 0) const

Utility function to return a const reference to the the unfiltered coherently summed waveform info of the polarisation of the most impulsive deconvolved wf Useful for TTree::Draw()

Parameters
paramwhichMetric 0 for Cosmin's impulsivityMeasure, 1 for Ben's fracPowerWindowGradient() (default = 0)
Returns
the unfiltered coherently summed waveform info corresponding to the most impulsive deconvolved wf

Definition at line 296 of file AnitaEventSummary.cc.

const AnitaEventSummary::WaveformInfo & AnitaEventSummary::mostImpulsiveCoherentFiltered ( int  whichMetric = 0) const

Utility function to return a const reference to the the filtered coherently summed waveform info of the polarisation of the most impulsive deconvolved wf Useful for TTree::Draw()

Parameters
paramwhichMetric 0 for Cosmin's impulsivityMeasure, 1 for Ben's fracPowerWindowGradient() (default = 0)
Returns
the filtered coherently summed waveform info corresponding to the most impulsive deconvolved wf

Definition at line 324 of file AnitaEventSummary.cc.

const AnitaEventSummary::WaveformInfo & AnitaEventSummary::mostImpulsiveDeconvolved ( int  whichMetric = 0) const

Utility function to return a const reference to the the most impulsive unfiltered, deconvolved coherently summed waveform info Useful for TTree::Draw()

Parameters
paramwhichMetric 0 for Cosmin's impulsivityMeasure, 1 for Ben's fracPowerWindowGradient() (default = 0)
Returns
the most impulsive unfiltered, deconvolved coherently summed waveform info

Definition at line 309 of file AnitaEventSummary.cc.

const AnitaEventSummary::WaveformInfo & AnitaEventSummary::mostImpulsiveDeconvolvedFiltered ( int  whichMetric = 0) const

Utility function to return a const reference to the the filtered, deconvolved coherently summed waveform info of the polarisation of the most impulsive deconvolved wf Useful for TTree::Draw()

Parameters
paramwhichMetric 0 for Cosmin's impulsivityMeasure, 1 for Ben's fracPowerWindowGradient() (default = 0)
Returns
the filtered, deconvolved coherently summed waveform info corresponding to the most impulsive deconvolved wf

Definition at line 337 of file AnitaEventSummary.cc.

int AnitaEventSummary::mostImpulsiveInd ( int  whichMetric = 0) const

Utility function to get the index of the most impulsive deconvolved wf Useful for TTree::Draw()

Parameters
paramwhichMetric 0 for Cosmin's impulsivityMeasure, 1 for Ben's fracPowerWindowGradient() (default = 0)
Returns
the index of the most impulsive deconvolved wf

Definition at line 269 of file AnitaEventSummary.cc.

const AnitaEventSummary::PointingHypothesis & AnitaEventSummary::mostImpulsivePeak ( int  whichMetric = 0) const

Utility function to return a const reference to the map peak corresponding to the most impulsive deconvolved wf Useful for TTree::Draw()

Parameters
paramwhichMetric 0 for Cosmin's impulsivityMeasure, 1 for Ben's fracPowerWindowGradient() (default = 0)
Returns
the peak with most impulsive deconvolved wf

Definition at line 283 of file AnitaEventSummary.cc.

AnitaPol::AnitaPol_t AnitaEventSummary::mostImpulsivePol ( int  whichMetric = 0) const

Utility function to get the polarisation of the most impulsive deconvolved coherently summed wf Useful for TTree::Draw()

Parameters
paramwhichMetric 0 for Cosmin's impulsivityMeasure, 1 for Ben's fracPowerWindowGradient() (default = 0)
Returns
the polarisation of the most impulsive deconvolved coherently summed wf

Definition at line 243 of file AnitaEventSummary.cc.

int AnitaEventSummary::mostImpulsivePolAsInt ( int  whichMetric = 0) const

Utility function to get the polarisation of the most impulsive deconvolved wf Useful for TTree::Draw()

Parameters
paramwhichMetric 0 for Cosmin's impulsivityMeasure, 1 for Ben's fracPowerWindowGradient() (default = 0)
Returns
the polarisation of the most impulsive deconvolved wf

Definition at line 256 of file AnitaEventSummary.cc.

void AnitaEventSummary::setSourceInformation ( UsefulAdu5Pat pat,
const TruthAnitaEvent truth = 0 
)

Set the source information using the GPS info (and MC truth if non-NULL)

Parameters
patis a pointer to the event GPS information
truthis a pointer to the MC Truth, default value is NULL

Definition at line 417 of file AnitaEventSummary.cc.

void AnitaEventSummary::setTriggerInfomation ( const RawAnitaHeader header)

Set trigger information in EventFlags directly from the header

Parameters
headeris a pointer to the event header

Definition at line 369 of file AnitaEventSummary.cc.

AnitaPol::AnitaPol_t AnitaEventSummary::trainingPol ( ) const

Return the weight of the event, always returns 1 for data, the weight from MCTruth otherwise.

Get the polarisation of the peak best corresponding to the MC peak In the case of data, just returns the highestPeak

Returns
the polarisation of the peak closest to MC truth (or highest peak if data)

Definition at line 944 of file AnitaEventSummary.cc.

void AnitaEventSummary::zeroInternals ( )

Set everything to zero, should be called in constructor

Definition at line 92 of file AnitaEventSummary.cc.


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