| 1 |
\hypertarget{classCollectionAction}{ |
| 2 |
\section{CollectionAction Class Reference} |
| 3 |
\label{classCollectionAction}\index{CollectionAction@{CollectionAction}} |
| 4 |
} |
| 5 |
An abstract class that defines the interface of a generic collection action. |
| 6 |
|
| 7 |
|
| 8 |
{\tt \#include $<$CollectionAction.h$>$} |
| 9 |
|
| 10 |
Inheritance diagram for CollectionAction::\begin{figure}[H] |
| 11 |
\begin{center} |
| 12 |
\leavevmode |
| 13 |
\includegraphics[height=1.4359cm]{classCollectionAction} |
| 14 |
\end{center} |
| 15 |
\end{figure} |
| 16 |
\subsection*{Public Member Functions} |
| 17 |
\begin{CompactItemize} |
| 18 |
\item |
| 19 |
\hyperlink{classCollectionAction_35e6d0d0351e0fafe4b508faeb3598d6}{CollectionAction} (const char $\ast$actionName) |
| 20 |
\begin{CompactList}\small\item\em Constructor. \item\end{CompactList}\item |
| 21 |
virtual \hyperlink{classCollectionAction_d327a6cfdc6148db563ae52aa004e098}{$\sim$CollectionAction} () |
| 22 |
\begin{CompactList}\small\item\em Destructor. \item\end{CompactList}\item |
| 23 |
virtual void \hyperlink{classCollectionAction_13adbcacf5e088f7979f0644a65372b4}{Setup} (PamLevel2 $\ast$events) |
| 24 |
\begin{CompactList}\small\item\em The initialization routine. \item\end{CompactList}\item |
| 25 |
virtual void \hyperlink{classCollectionAction_801dd664020b71e8a3232e5a584d96a0}{OnGood} (PamLevel2 $\ast$event)=0 |
| 26 |
\begin{CompactList}\small\item\em Routine for selected events. \item\end{CompactList}\item |
| 27 |
virtual void \hyperlink{classCollectionAction_ef4ee9fd63c0d232e90694e068e6e339}{OnBad} (PamLevel2 $\ast$event, int selectionResult) |
| 28 |
\begin{CompactList}\small\item\em Routine for discarded events. \item\end{CompactList}\item |
| 29 |
virtual void \hyperlink{classCollectionAction_c32b42fc08bc1be7b003579b633de041}{Finalize} ()=0 |
| 30 |
\begin{CompactList}\small\item\em The finalization routine. \item\end{CompactList}\item |
| 31 |
const char $\ast$ \hyperlink{classCollectionAction_96783ca0685b2095bf519c17a057c926}{GetName} () |
| 32 |
\begin{CompactList}\small\item\em Returns the action name. \item\end{CompactList}\end{CompactItemize} |
| 33 |
\subsection*{Private Attributes} |
| 34 |
\begin{CompactItemize} |
| 35 |
\item |
| 36 |
const char $\ast$ \hyperlink{classCollectionAction_5c046c663d75fdcb53d00cda91cc3509}{\_\-actionName} |
| 37 |
\end{CompactItemize} |
| 38 |
|
| 39 |
|
| 40 |
\subsection{Detailed Description} |
| 41 |
An abstract class that defines the interface of a generic collection action. |
| 42 |
|
| 43 |
The \hyperlink{classCollectionAction}{CollectionAction} abstract class defines an interface for a generic action object which can be used to implement common actions that can be done by collections, like filling histograms or saving selected events. The structure of this class mimicks that of a standard collection: it has a \hyperlink{classCollectionAction_13adbcacf5e088f7979f0644a65372b4}{Setup()} and a \hyperlink{classCollectionAction_c32b42fc08bc1be7b003579b633de041}{Finalize()} methods that are meant to be called at the beginning and at the end of the selection procedure, respectively. In \hyperlink{classCollectionAction_13adbcacf5e088f7979f0644a65372b4}{Setup()} one can prepare the analysis actions like instantiating a histogram object (this can be done also in the constructor), while in \hyperlink{classCollectionAction_c32b42fc08bc1be7b003579b633de041}{Finalize()} the analysis can be closed by, eg., writing histograms on a file and closing that file. The two methods \hyperlink{classCollectionAction_801dd664020b71e8a3232e5a584d96a0}{OnGood()} and \hyperlink{classCollectionAction_ef4ee9fd63c0d232e90694e068e6e339}{OnBad()} have exactly the same purpose they have in a Collection: to define action to perform each time an event is selected as good or bad. The class \hyperlink{classSmartCollection}{SmartCollection} is specially designed to handle \hyperlink{classCollectionAction}{CollectionAction} objects: see the documentation of \hyperlink{classSmartCollection}{SmartCollection} for info on how these objects are handled. |
| 44 |
|
| 45 |
Definition at line 30 of file CollectionAction.h. |
| 46 |
|
| 47 |
\subsection{Constructor \& Destructor Documentation} |
| 48 |
\hypertarget{classCollectionAction_35e6d0d0351e0fafe4b508faeb3598d6}{ |
| 49 |
\index{CollectionAction@{CollectionAction}!CollectionAction@{CollectionAction}} |
| 50 |
\index{CollectionAction@{CollectionAction}!CollectionAction@{CollectionAction}} |
| 51 |
\subsubsection[{CollectionAction}]{\setlength{\rightskip}{0pt plus 5cm}CollectionAction::CollectionAction (const char $\ast$ {\em actionName})\hspace{0.3cm}{\tt \mbox{[}inline\mbox{]}}}} |
| 52 |
\label{classCollectionAction_35e6d0d0351e0fafe4b508faeb3598d6} |
| 53 |
|
| 54 |
|
| 55 |
Constructor. |
| 56 |
|
| 57 |
\begin{Desc} |
| 58 |
\item[Parameters:] |
| 59 |
\begin{description} |
| 60 |
\item[{\em actionName}]The action's name. \end{description} |
| 61 |
\end{Desc} |
| 62 |
|
| 63 |
|
| 64 |
Definition at line 37 of file CollectionAction.h.\hypertarget{classCollectionAction_d327a6cfdc6148db563ae52aa004e098}{ |
| 65 |
\index{CollectionAction@{CollectionAction}!$\sim$CollectionAction@{$\sim$CollectionAction}} |
| 66 |
\index{$\sim$CollectionAction@{$\sim$CollectionAction}!CollectionAction@{CollectionAction}} |
| 67 |
\subsubsection[{$\sim$CollectionAction}]{\setlength{\rightskip}{0pt plus 5cm}virtual CollectionAction::$\sim$CollectionAction ()\hspace{0.3cm}{\tt \mbox{[}inline, virtual\mbox{]}}}} |
| 68 |
\label{classCollectionAction_d327a6cfdc6148db563ae52aa004e098} |
| 69 |
|
| 70 |
|
| 71 |
Destructor. |
| 72 |
|
| 73 |
|
| 74 |
|
| 75 |
Definition at line 41 of file CollectionAction.h. |
| 76 |
|
| 77 |
\subsection{Member Function Documentation} |
| 78 |
\hypertarget{classCollectionAction_c32b42fc08bc1be7b003579b633de041}{ |
| 79 |
\index{CollectionAction@{CollectionAction}!Finalize@{Finalize}} |
| 80 |
\index{Finalize@{Finalize}!CollectionAction@{CollectionAction}} |
| 81 |
\subsubsection[{Finalize}]{\setlength{\rightskip}{0pt plus 5cm}virtual void CollectionAction::Finalize ()\hspace{0.3cm}{\tt \mbox{[}pure virtual\mbox{]}}}} |
| 82 |
\label{classCollectionAction_c32b42fc08bc1be7b003579b633de041} |
| 83 |
|
| 84 |
|
| 85 |
The finalization routine. |
| 86 |
|
| 87 |
This method is intended to be called at the end of the analysis. Its implementations contain the finalizing procedures, like writing histograms to file or printing reports. It is automatically called by \hyperlink{classSmartCollection_8105730615ad127a482a7fb399695977}{SmartCollection::Finalize()}. |
| 88 |
|
| 89 |
Implemented in \hyperlink{classChargeHistosAction_b0aa2e207eea6e8f80c89197f9705dbe}{ChargeHistosAction}, \hyperlink{classEvRateS11VsCutoffHistoAction_71062bd029caf54cb174b9b8df5ed6ad}{EvRateS11VsCutoffHistoAction}, \hyperlink{classFluxHistoAction_4565d0ea3ca0f895af489455dfd5ff04}{FluxHistoAction}, and \hyperlink{classSaveEventsAction_790f534c0a888c2a57814cd859b97270}{SaveEventsAction}.\hypertarget{classCollectionAction_96783ca0685b2095bf519c17a057c926}{ |
| 90 |
\index{CollectionAction@{CollectionAction}!GetName@{GetName}} |
| 91 |
\index{GetName@{GetName}!CollectionAction@{CollectionAction}} |
| 92 |
\subsubsection[{GetName}]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ CollectionAction::GetName ()\hspace{0.3cm}{\tt \mbox{[}inline\mbox{]}}}} |
| 93 |
\label{classCollectionAction_96783ca0685b2095bf519c17a057c926} |
| 94 |
|
| 95 |
|
| 96 |
Returns the action name. |
| 97 |
|
| 98 |
|
| 99 |
|
| 100 |
Definition at line 89 of file CollectionAction.h. |
| 101 |
|
| 102 |
References \_\-actionName. |
| 103 |
|
| 104 |
Referenced by FluxHistoAction::Finalize().\hypertarget{classCollectionAction_ef4ee9fd63c0d232e90694e068e6e339}{ |
| 105 |
\index{CollectionAction@{CollectionAction}!OnBad@{OnBad}} |
| 106 |
\index{OnBad@{OnBad}!CollectionAction@{CollectionAction}} |
| 107 |
\subsubsection[{OnBad}]{\setlength{\rightskip}{0pt plus 5cm}virtual void CollectionAction::OnBad (PamLevel2 $\ast$ {\em event}, \/ int {\em selectionResult})\hspace{0.3cm}{\tt \mbox{[}inline, virtual\mbox{]}}}} |
| 108 |
\label{classCollectionAction_ef4ee9fd63c0d232e90694e068e6e339} |
| 109 |
|
| 110 |
|
| 111 |
Routine for discarded events. |
| 112 |
|
| 113 |
The concrete implementations define what to do when an event is discarded. This is conceptually the same as \hyperlink{classPamCut_cbb3b507d79f20878fac4392ffa57acb}{PamCut::OnBad()}. Call to this method is automatically done in \hyperlink{classSmartCollection_99ac049c98461fbe04167f386ca7ed76}{SmartCollection::OnBad()}. This method is not pure virtual, since many times there's nothing to do when a cut fails; this way, it's not necessary to implement it in derived classes. Current implementation is void. |
| 114 |
|
| 115 |
\begin{Desc} |
| 116 |
\item[Parameters:] |
| 117 |
\begin{description} |
| 118 |
\item[{\em event}]The selected event. \item[{\em selectionResult}]The code describing the reason of cut's failure (collections will automatically pass the index of the failed cut as selectionResult). \end{description} |
| 119 |
\end{Desc} |
| 120 |
|
| 121 |
|
| 122 |
Definition at line 78 of file CollectionAction.h.\hypertarget{classCollectionAction_801dd664020b71e8a3232e5a584d96a0}{ |
| 123 |
\index{CollectionAction@{CollectionAction}!OnGood@{OnGood}} |
| 124 |
\index{OnGood@{OnGood}!CollectionAction@{CollectionAction}} |
| 125 |
\subsubsection[{OnGood}]{\setlength{\rightskip}{0pt plus 5cm}virtual void CollectionAction::OnGood (PamLevel2 $\ast$ {\em event})\hspace{0.3cm}{\tt \mbox{[}pure virtual\mbox{]}}}} |
| 126 |
\label{classCollectionAction_801dd664020b71e8a3232e5a584d96a0} |
| 127 |
|
| 128 |
|
| 129 |
Routine for selected events. |
| 130 |
|
| 131 |
The concrete implementations define what to do when an event is selected. This is conceptually the same as \hyperlink{classPamCut_56021e959232270c12528ddec3062985}{PamCut::OnGood()}. Call to this method is automatically done in \hyperlink{classSmartCollection_13ce6deb47b60d10225598dd1201cd80}{SmartCollection::OnGood()}. |
| 132 |
|
| 133 |
\begin{Desc} |
| 134 |
\item[Parameters:] |
| 135 |
\begin{description} |
| 136 |
\item[{\em event}]The selected event. \end{description} |
| 137 |
\end{Desc} |
| 138 |
|
| 139 |
|
| 140 |
Implemented in \hyperlink{classChargeHistosAction_315d81cbff24a228c85b648393d67107}{ChargeHistosAction}, \hyperlink{classEvRateS11VsCutoffHistoAction_bb38c1bcb9d3e52abd6f929db8577ac6}{EvRateS11VsCutoffHistoAction}, \hyperlink{classFluxHistoAction_363f9657ac69e1051449ec1907c04809}{FluxHistoAction}, and \hyperlink{classSaveEventsAction_47e8259afe7a68ba3c0adf3bd79fe52a}{SaveEventsAction}.\hypertarget{classCollectionAction_13adbcacf5e088f7979f0644a65372b4}{ |
| 141 |
\index{CollectionAction@{CollectionAction}!Setup@{Setup}} |
| 142 |
\index{Setup@{Setup}!CollectionAction@{CollectionAction}} |
| 143 |
\subsubsection[{Setup}]{\setlength{\rightskip}{0pt plus 5cm}virtual void CollectionAction::Setup (PamLevel2 $\ast$ {\em events})\hspace{0.3cm}{\tt \mbox{[}inline, virtual\mbox{]}}}} |
| 144 |
\label{classCollectionAction_13adbcacf5e088f7979f0644a65372b4} |
| 145 |
|
| 146 |
|
| 147 |
The initialization routine. |
| 148 |
|
| 149 |
In this routine the initialization procedure is to be defined. \hyperlink{classSmartCollection}{SmartCollection} objects will call \hyperlink{classCollectionAction_13adbcacf5e088f7979f0644a65372b4}{Setup()} for each \hyperlink{classCollectionAction}{CollectionAction} object they hold during \hyperlink{classSmartCollection_9b5b11a854b9e174218ea516ceffb34c}{SmartCollection::Setup()}. This method is intended for some possible post-constructor initialization, like those who need to know the PamLevel2 object (eg., clone trees selection). This method is likely to be unnecessary most of the times, so it is implemented as a void function and it's not pure virtual. |
| 150 |
|
| 151 |
\begin{Desc} |
| 152 |
\item[Parameters:] |
| 153 |
\begin{description} |
| 154 |
\item[{\em events}]The PamLevel2 events which will be analyzed by the collection hosting the action. \end{description} |
| 155 |
\end{Desc} |
| 156 |
|
| 157 |
|
| 158 |
Reimplemented in \hyperlink{classSaveEventsAction_3a59e42181c79dcd192b0be3d14a34c2}{SaveEventsAction}. |
| 159 |
|
| 160 |
Definition at line 55 of file CollectionAction.h. |
| 161 |
|
| 162 |
\subsection{Member Data Documentation} |
| 163 |
\hypertarget{classCollectionAction_5c046c663d75fdcb53d00cda91cc3509}{ |
| 164 |
\index{CollectionAction@{CollectionAction}!\_\-actionName@{\_\-actionName}} |
| 165 |
\index{\_\-actionName@{\_\-actionName}!CollectionAction@{CollectionAction}} |
| 166 |
\subsubsection[{\_\-actionName}]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ {\bf CollectionAction::\_\-actionName}\hspace{0.3cm}{\tt \mbox{[}private\mbox{]}}}} |
| 167 |
\label{classCollectionAction_5c046c663d75fdcb53d00cda91cc3509} |
| 168 |
|
| 169 |
|
| 170 |
|
| 171 |
|
| 172 |
Definition at line 94 of file CollectionAction.h. |
| 173 |
|
| 174 |
Referenced by GetName(). |
| 175 |
|
| 176 |
The documentation for this class was generated from the following file:\begin{CompactItemize} |
| 177 |
\item |
| 178 |
CollectionActions/CollectionAction/\hyperlink{CollectionAction_8h}{CollectionAction.h}\end{CompactItemize} |
Parent Directory
| 
Revision Log