Index: trunk/MagicSoft/TDAS-Extractor/Algorithms.tex =================================================================== --- trunk/MagicSoft/TDAS-Extractor/Algorithms.tex (revision 5908) +++ trunk/MagicSoft/TDAS-Extractor/Algorithms.tex (revision 5909) @@ -60,8 +60,8 @@ The pedestals get subtracted automatically {\textit {\bf after}} execution of these two functions. -\item[MExtractTime:\xspace] This class provides - additionally to those already declared in {\textit{\bf MExtractor}}, +\item[MExtractTime:\xspace] This class provides - additionally to those already declared in {\textit{\bf MExtractor}} - the basic data members equal for all time extractors which are: \begin{enumerate} - \item Pointers to the used storage containers {\textit{\bf MArrivalTimeCam}} + \item Pointer to the used storage container {\textit{\bf MArrivalTimeCam}} parameterized by the variables {\textit{\bf fArrTime}}. @@ -86,5 +86,5 @@ \item[MExtractTimeAndCharge:\xspace] This class provides - additionally to those already declared in - {\textit{\bf MExtractor}} and {\textit{\bf MExtractTime}}, + {\textit{\bf MExtractor}} and {\textit{\bf MExtractTime}} - the basic data members equal for all time and charge extractors which are: \begin{enumerate} @@ -109,6 +109,6 @@ where the pointers ``firstused'' point to the first used FADC slice declared by the extraction ranges, - the pointer ``lowgain'' point to the beginning of the low-gain FADC slices array (to be used for - pulses reaching into the low-gain array), + the pointer ``logain'' point to the beginning of the low-gain FADC slices array (to be used for + pulses reaching into the ``low-gain'' array), the variables ``sum'', ``dsum'' get filled with the extracted signal and its error. The variables ``time'', ``dtime'' and ``sat'' get filled with the @@ -131,8 +131,8 @@ \end{itemize} -The following freely adjustable parameters have to be set from outside: -\begin{description} -\item[Global extraction limits:\xspace] Limits in between the extractor is allowed -to search, independently for high gain and low gain. +The following adjustable parameters have to be set from outside: +\begin{description} +\item[Global extraction limits:\xspace] Limits in between which the extractor is allowed +to extract the signal, for high gain and low gain, respectively. \end{description} @@ -146,6 +146,6 @@ \subsubsection{Fixed Window} -This extractor is implemented in the MARS-class {\textit{MExtractFixedWindow}}. -It simply adds the FADC contents in the assigned ranges. +This extractor is implemented in the MARS-class {\textit{\bf MExtractFixedWindow}}. +It simply adds the FADC slice contents in the assigned ranges. As it does not correct for the clock-noise, only an even number of samples is allowed. Figure~\ref{fig:fixedwindowsketch} gives a sketch of the used extraction ranges for this @@ -156,7 +156,7 @@ \includegraphics[width=0.49\linewidth]{MExtractFixedWindow_23Led_Blue.eps} \caption[Sketch extraction ranges MExtractFixedWindow]{% -Sketch of the extraction ranges for the extractor {\textit{MExtractFixedWindow}} +Sketch of the extraction ranges for the extractor {\textit{\bf MExtractFixedWindow}} for two typical calibration pulses (pedestals have been subtracted) and a typical inner pixel. -The pulse would be shifted half a slice to the right for an outer pixels. } +The pulse would be shifted half a slice to the right for an outer pixel. } \label{fig:fixedwindowsketch} \end{figure} @@ -165,8 +165,7 @@ \subsubsection{Fixed Window with Integrated Cubic Spline} -This extractor is implemented in the MARS-class {\textit{MExtractFixedWindowSpline}}, -using a cubic spline algorithm, adapted from \cite{NUMREC}. -It integrated the -spline interpolated FADC slice values. The edge slices are counted as half. +This extractor is implemented in the MARS-class {\textit{\bf MExtractFixedWindowSpline}}. It +uses a cubic spline algorithm, adapted from \cite{NUMREC} and integrates the +spline interpolated FADC slice values from a fixed extraction range. The edge slices are counted as half. As it does not correct for the clock-noise, only an odd number of samples is allowed. Figure~\ref{fig:fixedwindowsplinesketch} gives a sketch of the used extraction ranges for this @@ -177,7 +176,7 @@ \includegraphics[width=0.49\linewidth]{MExtractFixedWindowSpline_23Led_Blue.eps} \caption[Sketch extraction ranges MExtractFixedWindowSpline]{% -Sketch of the extraction ranges for the extractor {\textit{MExtractFixedWindowSpline}} +Sketch of the extraction ranges for the extractor {\textit{\bf MExtractFixedWindowSpline}} for two typical calibration pulses (pedestals have been subtracted) and a typical inner pixel. -The pulse would be shifted half a slice to the right for an outer pixels. } +The pulse would be shifted half a slice to the right for an outer pixel. } \label{fig:fixedwindowsplinesketch} \end{figure} @@ -185,18 +184,19 @@ \subsubsection{Fixed Window with Global Peak Search} -This extractor is implemented in the MARS-class {\textit{MExtractFixedWindowPeakSearch}}. -It fixes first a reference point defined as the highest sum of -consecutive non-saturating FADC slices in a (smaller) peak-search window. This reference -point removes the coherent movement of the arrival times in the whole camera due to the trigger jitter. +This extractor is implemented in the MARS-class {\textit{\bf MExtractFixedWindowPeakSearch}}. +The basic idea of this extractor is to correct for coherent movements in arrival time for all pixels, +as e.g. caused by the trigger jitter. +In a first loop, it fixes a reference point defined as the highest sum of +consecutive non-saturating FADC slices in a (smaller) peak-search window. \par In a second loop over the pixels, -it adds the FADC contents starting from a pre-defined point before the obtained peak-search window +it adds the FADC contents starting from a pre-defined offset from the obtained peak-search window over an extraction window of a pre-defined window size. It loops twice over all pixels in every event, because it has to find the reference point, first. As it does not correct for the clock-noise, only an even number of samples is allowed. -The following freely adjustable parameters have to be set from outside: -\begin{description} -\item[Peak Search Window:\xspace] Defines the ``sliding window'' in which the peaking sum is +The following adjustable parameters have to be set from outside: +\begin{description} +\item[Peak Search Window:\xspace] Defines the ``sliding window'' size within which the peaking sum is searched for (default: 4 slices) \item[Offset from Window:\xspace] Defines the offset of the start of the extraction window w.r.t. the @@ -691,3 +691,4 @@ %%% TeX-master: "MAGIC_signal_reco" %%% TeX-master: "MAGIC_signal_reco" +%%% TeX-master: "MAGIC_signal_reco" %%% End: