REST-for-Physics  v2.3
Rare Event Searches ToolKit for Physics
Public Member Functions | Private Member Functions | Private Attributes
TRestTrack2DAnalysisProcess Class Reference

Detailed Description

An analysis REST process to extract valuable information from Track type of data.

Analysis process for 2D tracks, XZ-YZ. For other types of tracks all observables are 0. XZ_YZ means values from both types of tracks are involved.

Observables

"NTracks", fTrackEvent->GetNumberOfTracks()); "NTracksX", Number of XZ tracks "NTracksY", Number of YZ tracks "TotalEnergy", fTrackEvent->GetEnergy()); "XZ_TotalEnergyX", Energy in all XZ tracks "YZ_TotalEnergyY", Energy in all YZ tracks "XZ_YZ_MaxTrackEnergy", energiesX[0].second + energiesY[0].second (first tracks in XZ and YZ are added) "XZ_YZ_MaxTrackEnergyPercentage", Percentage of first track (XZ YZ added) energy from total energy "XZ_YZ_MaxTrackEnergyBalanceXY", Energy balance between X and Y in first track "XZ_YZ_SecondMaxTrackEnergy", energiesX[1].second + energiesY[1].second (second tracks in XZ and YZ are added) "XZ_YZ_SecondMaxTrackEnergyPercentage", Percentage of second track (XZ YZ added) energy from total energy "XZ_YZ_SecondMaxTrackEnergyBalanceXY", Energy balance between X and Y in first track

"XZ_FirstSecondTracksDistanceXZ", Distance in XZ plane of mean positions of first two XZ tracks "YZ_FirstSecondTracksDistanceYZ", Distance in YZ plane of mean positions of first two YZ tracks "XZ_YZ_FirstSecondTracksDistanceSum", Root of squared sum of previous two

Map observables, there are the same observables for first and second tracks. MaxTrack_... and SecondMaxTrack_... Map observables have values for each track of each observable. If XZ observable in a YZ track -> = 0 and viceversa.

SetObservableValue("Map_XZ_EnergyX", XZ_EnergyX); SetObservableValue("Map_XZ_SigmaX", XZ_SigmaX); SetObservableValue("Map_XZ_SigmaZ", XZ_SigmaZ); SetObservableValue("Map_XZ_GaussSigmaX", XZ_GaussSigmaX); SetObservableValue("Map_XZ_GaussSigmaZ", XZ_GaussSigmaZ); SetObservableValue("Map_XZ_LengthX", XZ_LengthX); SetObservableValue("Map_XZ_VolumeX", XZ_VolumeX); SetObservableValue("Map_XZ_MeanX", XZ_MeanX); SetObservableValue("Map_XZ_MeanZ", XZ_MeanZ); SetObservableValue("Map_XZ_SkewZ", XZ_SkewZ);

SetObservableValue("Map_YZ_EnergyY", YZ_EnergyY); SetObservableValue("Map_YZ_SigmaY", YZ_SigmaY); SetObservableValue("Map_YZ_SigmaZ", YZ_SigmaZ); SetObservableValue("Map_YZ_GaussSigmaY", YZ_GaussSigmaY); SetObservableValue("Map_YZ_GaussSigmaZ", YZ_GaussSigmaZ); SetObservableValue("Map_YZ_LengthY", YZ_LengthY); SetObservableValue("Map_YZ_VolumeY", YZ_VolumeY); SetObservableValue("Map_YZ_MeanY", YZ_MeanY); SetObservableValue("Map_YZ_MeanZ", YZ_MeanZ); SetObservableValue("Map_YZ_SkewZ", YZ_SkewZ);

SetObservableValue("Map_XZ_YZ_SigmaXYBalance", XZ_YZ_SigmaXYBalance); SetObservableValue("Map_XZ_YZ_SigmaZBalance", XZ_YZ_SigmaZBalance); SetObservableValue("Map_XZ_YZ_GaussSigmaXYBalance", XZ_YZ_GaussSigmaXYBalance); SetObservableValue("Map_XZ_YZ_GaussSigmaZBalance", XZ_YZ_GaussSigmaZBalance);


RESTsoft - Software for Rare Event Searches with TPCs

History of developments:

2024-March: Analysis for 2D tracks (XZ-YZ) David Diez Ibanez

Author
David Diez Ibanez

Definition at line 31 of file TRestTrack2DAnalysisProcess.h.

#include <TRestTrack2DAnalysisProcess.h>

Inheritance diagram for TRestTrack2DAnalysisProcess:
TRestEventProcess TRestMetadata

Public Member Functions

 ClassDefOverride (TRestTrack2DAnalysisProcess, 1)
 
void EndProcess () override
 To be executed at the end of the run (outside event loop) More...
 
RESTValue GetInputEvent () const override
 Get pointer to input event. Must be implemented in the derived class. More...
 
RESTValue GetOutputEvent () const override
 Get pointer to output event. Must be implemented in the derived class. More...
 
const char * GetProcessName () const override
 
void InitProcess () override
 To be executed at the beginning of the run (outside event loop) More...
 
void LoadConfig (const std::string &configFilename, const std::string &name="")
 
void PrintMetadata () override
 Implemented it in the derived metadata class to print out specific metadata information. More...
 
TRestEventProcessEvent (TRestEvent *inputEvent) override
 Process one event. More...
 
 TRestTrack2DAnalysisProcess (const char *configFilename)
 
- Public Member Functions inherited from TRestEventProcess
virtual Bool_t AddInputFile (const std::string &file)
 
bool ApplyCut ()
 
virtual void BeginOfEventProcess (TRestEvent *inputEvent=nullptr)
 Begin of event process, preparation work. Called right before ProcessEvent() More...
 
 ClassDefOverride (TRestEventProcess, 3)
 
virtual void EndOfEventProcess (TRestEvent *inputEvent=nullptr)
 End of event process. Nothing to do. Called directly after ProcessEvent() More...
 
virtual void EndProcess ()
 To be executed at the end of the run (outside event loop) More...
 
TRestAnalysisTreeGetAnalysisTree () const
 Return the local analysis tree (dummy) More...
 
TCanvas * GetCanvas () const
 Get canvas. More...
 
TRestAnalysisTreeGetFullAnalysisTree ()
 
virtual RESTValue GetInputEvent () const =0
 Get pointer to input event. Must be implemented in the derived class. More...
 
std::vector< std::string > GetListOfAddedObservables ()
 
virtual RESTValue GetOutputEvent () const =0
 Get pointer to output event. Must be implemented in the derived class. More...
 
virtual const char * GetProcessName () const =0
 
TRestRunGetRunInfo () const
 Return the pointer of the hosting TRestRun object. More...
 
virtual Long64_t GetTotalBytes () const
 
virtual Long64_t GetTotalBytesRead () const
 Interface to external file reading, get the read bytes. To be implemented in external processes. More...
 
virtual void InitFromConfigFile () override
 To make settings from rml file. This method must be implemented in the derived class. More...
 
virtual void InitProcess ()
 To be executed at the beginning of the run (outside event loop) More...
 
Bool_t isExternal () const
 Return whether this process is external process. More...
 
Int_t LoadSectionMetadata () override
 This method does some preparation of xml section. More...
 
virtual void NotifyAnalysisTreeReset ()
 In case the analysis tree is reset(switched to new file), some process needs to have action. More...
 
virtual Bool_t OpenInputFiles (const std::vector< std::string > &files)
 
virtual TRestEventProcessEvent (TRestEvent *inputEvent)=0
 Process one event. More...
 
std::vector< std::string > ReadObservables ()
 
void RegisterAllObservables (Bool_t value=true)
 
virtual Bool_t ResetEntry ()
 
void SetAnalysisTree (TRestAnalysisTree *tree)
 Set analysis tree of this process, then add observables to it.
 
void SetCanvasSize (Int_t x, Int_t y)
 Set canvas size. More...
 
void SetFriendProcess (TRestEventProcess *p)
 Add friendly process to this process.
 
void SetObservableValidation (bool validate)
 
void SetParallelProcess (TRestEventProcess *p)
 Add parallel process to this process.
 
void SetRunInfo (TRestRun *r)
 Set TRestRun for this process. More...
 
Bool_t singleThreadOnly () const
 Return whether this process is single std::thread only. More...
 
 TRestEventProcess ()
 
 ~TRestEventProcess ()
 

Private Member Functions

void InitFromConfigFile () override
 To make settings from rml file. This method must be implemented in the derived class. More...
 
void Initialize () override
 Making default settings. More...
 
void LoadDefaultConfig ()
 

Private Attributes

TRestTrackEventfTrackEvent
 

Additional Inherited Members

- Protected Types inherited from TRestEventProcess
enum  REST_Process_Output { No_Output , Observable , Internal_Var , Full_Output }
 
- Protected Member Functions inherited from TRestEventProcess
void BeginPrintProcess ()
 [name, cut range]
 
void CreateCanvas ()
 Create the canvas. More...
 
void EndPrintProcess ()
 
TRestEventProcessGetFriend (const std::string &nameOrType)
 
TRestEventProcessGetFriendLive (const std::string &nameOrType)
 
template<class T >
T * GetMetadata ()
 Get a metadata object from the host TRestRun. More...
 
TRestMetadataGetMetadata (const std::string &nameOrType)
 
size_t GetNumberOfParallelProcesses () const
 
template<class T >
GetObservableValue (const std::string &name)
 
TRestEventProcessGetParallel (int i)
 
template<class T >
std::vector< T > GetParallelDataMembers (T *member_of_process)
 Get a list of data members from parallel processes which is same to this process's certain data member. More...
 
template<class T >
void SetObservableValue (const std::string &name, const T &value)
 Set observable value for AnalysisTree. More...
 
- Protected Attributes inherited from TRestEventProcess
TRestAnalysisTreefAnalysisTree = nullptr
 
TCanvas * fCanvas = nullptr
 < Canvas for some viewer event More...
 
TVector2 fCanvasSize
 Canvas size. More...
 
std::vector< std::pair< std::string, TVector2 > > fCuts
 Stores cut definitions. Any listed observables should be in the range. More...
 
bool fDynamicObs = false
 It defines whether to use added observables only or all the observables appear in the code. More...
 
bool fIsExternal = false
 It defines if the process reads event data from an external source. More...
 
std::map< std::string, int > fObservablesDefined
 Stores the list of all the appeared process observables in the code. More...
 
std::map< std::string, int > fObservablesUpdated
 Stores the list of process observables updated when processing this event. More...
 
bool fReadOnly = false
 not used, keep for compatibility More...
 
TRestRunfRunInfo = nullptr
 < Pointer to TRestRun object where to find metadata. More...
 
bool fSingleThreadOnly = false
 
bool fValidateObservables = false
 It defines if observable names should be added to the validation list. More...
 

Constructor & Destructor Documentation

◆ TRestTrack2DAnalysisProcess() [1/2]

TRestTrack2DAnalysisProcess::TRestTrack2DAnalysisProcess ( )

Definition at line 111 of file TRestTrack2DAnalysisProcess.cxx.

◆ TRestTrack2DAnalysisProcess() [2/2]

TRestTrack2DAnalysisProcess::TRestTrack2DAnalysisProcess ( const char *  configFilename)

Definition at line 113 of file TRestTrack2DAnalysisProcess.cxx.

◆ ~TRestTrack2DAnalysisProcess()

TRestTrack2DAnalysisProcess::~TRestTrack2DAnalysisProcess ( )

Definition at line 120 of file TRestTrack2DAnalysisProcess.cxx.

Member Function Documentation

◆ EndProcess()

void TRestTrack2DAnalysisProcess::EndProcess ( )
overridevirtual

To be executed at the end of the run (outside event loop)

Reimplemented from TRestEventProcess.

Definition at line 625 of file TRestTrack2DAnalysisProcess.cxx.

◆ GetInputEvent()

RESTValue TRestTrack2DAnalysisProcess::GetInputEvent ( ) const
inlineoverridevirtual

Get pointer to input event. Must be implemented in the derived class.

Implements TRestEventProcess.

Definition at line 43 of file TRestTrack2DAnalysisProcess.h.

◆ GetOutputEvent()

RESTValue TRestTrack2DAnalysisProcess::GetOutputEvent ( ) const
inlineoverridevirtual

Get pointer to output event. Must be implemented in the derived class.

Implements TRestEventProcess.

Definition at line 44 of file TRestTrack2DAnalysisProcess.h.

◆ GetProcessName()

const char * TRestTrack2DAnalysisProcess::GetProcessName ( ) const
inlineoverridevirtual

Implements TRestEventProcess.

Definition at line 60 of file TRestTrack2DAnalysisProcess.h.

◆ InitFromConfigFile()

void TRestTrack2DAnalysisProcess::InitFromConfigFile ( )
overrideprivatevirtual

To make settings from rml file. This method must be implemented in the derived class.

Reimplemented from TRestEventProcess.

Definition at line 627 of file TRestTrack2DAnalysisProcess.cxx.

◆ Initialize()

void TRestTrack2DAnalysisProcess::Initialize ( )
overrideprivatevirtual

Making default settings.

Reimplemented from TRestMetadata.

Definition at line 124 of file TRestTrack2DAnalysisProcess.cxx.

◆ InitProcess()

void TRestTrack2DAnalysisProcess::InitProcess ( )
overridevirtual

To be executed at the beginning of the run (outside event loop)

Reimplemented from TRestEventProcess.

Definition at line 135 of file TRestTrack2DAnalysisProcess.cxx.

◆ LoadConfig()

void TRestTrack2DAnalysisProcess::LoadConfig ( const std::string &  configFilename,
const std::string &  name = "" 
)

Definition at line 131 of file TRestTrack2DAnalysisProcess.cxx.

◆ LoadDefaultConfig()

void TRestTrack2DAnalysisProcess::LoadDefaultConfig ( )
private

Definition at line 122 of file TRestTrack2DAnalysisProcess.cxx.

◆ PrintMetadata()

void TRestTrack2DAnalysisProcess::PrintMetadata ( )
inlineoverridevirtual

Implemented it in the derived metadata class to print out specific metadata information.

Prints metadata content on screen. Usually overloaded by the derived metadata class.

Reimplemented from TRestMetadata.

Definition at line 52 of file TRestTrack2DAnalysisProcess.h.

◆ ProcessEvent()

TRestEvent * TRestTrack2DAnalysisProcess::ProcessEvent ( TRestEvent inputEvent)
overridevirtual

Process one event.

-----------------------------------------------— /// ---------------— OBSERVABLES ----------------— /// -----------------------------------------------— ///

Energy by X and Y

Number of tracks per type

---— MAP OBSERVABLES ---— //// Energy per type of track

Number of hits in the track

Standard deviation observables

Gauss sigma observables

Spatial measurements

Distances between biggest two tracks in energy

Skew combining XZ and YZ max tracks

-------------------------------------------------------— /// ---------------— COMPUTE OBSERVABLES ----------------— /// -------------------------------------------------------— ///

Map observables

Sort tracks by energy ///

From map to vector

Sort the vector by decreasing order of its pair's second value

Observables "balance", between max track in X and max track in Y

Distance between first two tracks

Energy observables

Skew and sigma Z observables combining max tracks in XZ and YZ

----------------------------------------------------------— /// ---------------— SET OBSERVABLES VALUES ----------------— /// ----------------------------------------------------------— ///

Implements TRestEventProcess.

Definition at line 137 of file TRestTrack2DAnalysisProcess.cxx.

Field Documentation

◆ fTrackEvent

TRestTrackEvent* TRestTrack2DAnalysisProcess::fTrackEvent
private

Definition at line 33 of file TRestTrack2DAnalysisProcess.h.


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