Add first version of the TRD software writeup

[u/mrichter/AliRoot.git] / TRD / doc / trd_software_writeup.tex

% ---------------------------------------------------------------------
%
% TRD Software Writeup
%
% ---------------------------------------------------------------------
%
\documentclass{alicetdr}
%\documentclass[draft]{alicetdr}
%
% For figures
\usepackage{graphicx}
%
% Helvetica
\usepackage{helvet}
\renewcommand{\rmdefault}{phv}
\renewcommand{\sfdefault}{phv}
%
\let\Otemize =\itemize
\let\Onumerate =\enumerate
\let\Oescription =\description
% Zero the vertical spacing parameters
\def\Nospacing{\itemsep=0pt\topsep=0pt\partopsep=0pt\parskip=0pt\parsep=0pt}
\def\Topspac{\vspace{-0.5\baselineskip}}
\def\Botspac{\vspace{-0.2\baselineskip}}
% Redefine the environments in terms of the original values
\newenvironment{Itemize}{\Topspac\Otemize\Nospacing}{\endlist\Botspac}
\newenvironment{Enumerate}{\Topspac\Onumerate\Nospacing}{\endlist\Botspac}
\newenvironment{Description}{\Topspac\Oescription\Nospacing}{\endlist\Botspac}
%
\include{alicedefs}
%
\begin{document}
%
\pagenumbering{roman}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% Title page
%
\font\HUGEA=phvr at 36mm  % declare very big font
\font\HUGEB=phvr at 14mm  % declare very big font
%
\begin{titlepage}
%
\vspace{10.0cm}
%
\begin{center}
{\HUGEA T\hspace{5.mm}R\hspace{5.mm}D} \\
%
\vspace{3.5cm}
{\HUGEB Offline Software Writeup} \\
%
\vspace{2.0cm}
{\Large Version 1.0, \today}\\
%
\vfill
%
\vspace{5.5cm}
%
\end{center}
%
\end{titlepage}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% Empty page to adjust page numbering
%
\onecolumn
\thispagestyle{empty}
\mbox{  }
%
\setcounter{page}{0}
\onecolumn
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\pagenumbering{arabic}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% Text
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\setcounter{chapter}{0}
\setcounter{section}{0}    
\Chapter{Introduction}
\thispagestyle{empty}
%
This document is supposed to provide a description of the offline
software components that are specific to the TRD.  It is an attempt
to collect useful informations on the design and usage of the TRD
software, in order to facilitate newcomers the introduction to the
code.  The most important classes and procedures are described and
several examples und use cases are given.
However, this writeup is not meant to be a basic AliRoot introduction.  
For this purpose the reader is referred to the general AliRoot users 
guide \cite{ALIROOT}. 
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newpage
\setcounter{chapter}{1}
\setcounter{section}{0}    
\Chapter{Simulation}
\thispagestyle{empty}
%
\section{Geometry}
\label{GEO:intro}
%
{\it Author: C.~Blume (blume@ikf.uni-frankfurt.de)}
\smallskip
\\
%
The TRD geometry, as implemented in {\tt AliTRDgeometry}, consists of 
several components: The readout chambers (ROC), the services, and the 
supermodule frame.  All these parts are placed inside the TRD mother 
volumes, which in turn are part of the space frame geometry 
({\tt AliFRAMEv2}).  Therefore, the space frame geometry has to be 
present to build the TRD geometry.  For each of the 18 supermodules 
one single mothervolume is provided (BTRDxx).  This allows to configure 
the TRD geometry in {\tt Config.C} such that it only contains a subset 
of supermodules in the total ALICE geometry via 
{\tt AliTRDgeometry::SetSMstatus()}.  An incomplete detector setup, as
it exists for first data taking, can thus be modelled.  The class
{\tt AliTRDgeometry} also serves as the central place to collect all
geometry relevant numbers and the definitions of various numbering
schemes of detector components (e.g. sector numbers).  However, all 
geometric parameters that refer to the pad planes are compiled in
{\tt AliTRDpadPlane}.
%
\subsection{Readout Chambers}
\label{GEO:rocs}
%
\begin{figure}[htb]
\begin{center}
\includegraphics[width=0.85\textwidth]{plots/geo_roc.eps}
\end{center}
\caption{
A TRD read out chamber as implemented in the AliRoot geometry.  The
various material layers are visible.  Also, the MCMs on top of the
chamber, as well as the cooling pipes are shown.
}
\label{FIG_GEO:roc_geom}
\end{figure}
%
All ROCs are modelled in the same way, only their dimensions vary.  
They consist of an aluminum frame, which contains the material for 
the radiator and the gas of the drift region, a Wacosit frame (whose 
material is represented by carbon), that surrounds the amplification 
region, and the support structure, consisting of its aluminum frame, 
material for the read out pads, back panel, and readout boards).  The 
material inside the active parts of the chambers (radiator, gas, wire 
planes, pad planes, glue, read out boards, etc.) is introduced by 
uniform layers of the corresponding material, whose thicknesses were 
chosen such to result in the correct radiation length.  On top of the
individual ROCs the multi chip modules (MCM) as well as the cooling 
pipes and cables are placed.  One obvious simplification, already visible
in Fig.~\ref{FIG_GEO:roc_geom}, is that in the AliRoot geometry the pipes
run straight across the chambers instead of following the meandering path 
as in reality.
%
\subsection{Supermodules}
\label{GEO:smframes}
%
\begin{figure}[htb]
\begin{center}
\begin{minipage}[b]{0.49\textwidth}
\begin{center}
\includegraphics[width=0.65\textwidth,angle=270]{plots/geo_smframe.eps}
\end{center}
\end{minipage}
\begin{minipage}[b]{0.49\textwidth}
\begin{center}
\includegraphics[width=0.70\textwidth,angle=270]{plots/geo_sm.eps}
\end{center}
\end{minipage}
\end{center}
\caption{
A TRD supermodule, as implemented in the AliRoot geometry.  The left
panel shows only the support structures of the aluminum frame, together
with some service elements.  The right panel shows a complete 
supermodule including some surrounding parts of the space frame.
}
\label{FIG_GEO:sm_geom}
\end{figure}
%
The supermodule frames consist of the aluminum sheets on the sides, top,
and bottom of a supermodule together with the traversing support structures.
The left panel of Fig.~\ref{FIG_GEO:sm_geom} shows the structures that are
implemented in the TRD geometry.  Also, parts of the services like the LV
power bus bars and cooling arterias can be seen.  Additional electronics 
equipment (e.g. ``Sch\"utten-Box``) is represented by aluminum boxes that 
contain corresponding copper layers to mimic the present material.  The 
services also include e.g. gas distribution boxes, cooling pipes, power and
readout cables, and power connection panels.  Part of the services extend
into the baby and the back frame.  Therefore, additional mother volumes
have been introduced in order to accomodate this material.  All supermodules 
have inserts of carbon fiber sheets in the bottom part of the aluminum 
casing, for the ones in front of the PHOS detector (sectors 11--15) also 
the top part includes carbon fiber inserts.  The supermodules in the sectors 
13--15 do not contain any ROCs in the middle stack in order to provide the 
holes for the PHOS detector.  Instead, gas tubes of stainless steel have
been built in.
%
Generally, the TRD volumina start with the letter  ``{\bf U}''.  The geometry
is defined by the function {\tt AliTRDgeometry::CreateGeometry()}, which
generates the TRD mother volumes ({\bf UTI1}, {\bf UTI2}, {\bf UTI3}) and the 
volumes that constitute a single ROC.  This function in turn also calls 
{\tt AliTRDgeometry::CreateFrame()} to create the TRD support frame, 
{\tt AliTRDgeometry::CreateServices()} to create the services, and 
{\tt AliTRDgeometry::GroupChambers()} which assembles the alignable
volumes for a single ROC ({\bf UTxx}, where {\bf xx} is the detector
number {\bf DET-SEC}, defined inside a single super module, see below). The
materials, together with their tracking parameters, that are assigned to
the volumina, are defined in {\tt AliTRD::CreateMaterials()}.
In the following table the most important TRD volumina are described
({\bf xx} = {\bf DET-SEC} number):
%
\begin{center}
\begin{tabular}{l|l}
Name       & Description                                                                \\ \hline
{\bf UTR1} & TRD mothervolume for default supermodules                                  \\
{\bf UTR2} & TRD mothervolume for supermodules in front of PHOS                         \\
{\bf UTR3} & As {\bf UTR2}, but w/o middle stack                                        \\ \hline
{\bf UTxx} & Top volume of a single ROC                                                 \\ 
           & Defines the alignable volume for a single ROC                              \\ \hline
{\bf UAxx} & Lower part of the ROCs, including drift volume and radiator                \\
{\bf UDxx} & Amplification region                                                       \\
{\bf UFxx} & Back panel, including pad planes and PCB boards of readout electronics     \\
{\bf UUxx} & Contains services on chambers (cooling, cables, DCS boards) and MCM chips  \\
\end{tabular}
\end{center}
%
\subsection{Material Budget and Weight}
%
\begin{figure}[htb]
\begin{center}
\includegraphics[width=0.75\textwidth]{plots/geo_material_budget.eps}
\end{center}
\caption{
The radiation length map in units of $X/X_{0}$ in part of the active 
detector area of super module 0 as a function of the pseudorapidity 
$\eta$ and the azimuth angle $\phi$, calculated from the geometry in 
AliRoot.  Visible are the positions of the MCMs and the cooling pipes 
as hot spots.
}
\label{FIG_GEO:mat_budget}
\end{figure}
%
The volumina defining a ROC contain several layers that represent the 
different materials present inside a chamber and which therefore define 
the material budget inside the sensitive areas:
\begin{center}
\begin{tabular}{l|l|l|l|c|c|c}
Name         & Mother & Material    & Description                  & Thickness & Density      & $X/X_{0}$ \\ 
             &        &             &                              & [cm]      & [g/cm$^{3}$] & [\%]      \\ \hline
{\bf URMYxx} & UAxx   & Mylar       & Mylar layer on radiator (x2) & 0.0015    & 1.39         & 0.005     \\
{\bf URCBxx} & UAxx   & Carbon      & Carbon fiber mats (x2)       & 0.0055    & 1.75         & 0.023     \\
{\bf URGLxx} & UAxx   & Araldite    & Glue on the fiber mats (x2)  & 0.0065    & 1.12         & 0.018     \\
{\bf URRHxx} & UAxx   & Rohacell    & Sandwich structure (x2)      & 0.8       & 0.075        & 0.149     \\
{\bf URFBxx} & UAxx   & PP          & Fiber mats inside radiator   & 3.186     & 0.068        & 0.490     \\ \hline
{\bf UJxx}   & UAxx   & Xe/CO$_{2}$ & The drift region             & 3.0       & 0.00495      & 0.167     \\ 
{\bf UKxx}   & UDxx   & Xe/CO$_{2}$ & The amplification region     & 0.7       & 0.00495      & 0.039     \\ 
{\bf UWxx}   & UKxx   & Copper      & Wire planes (x2)             & 0.00011   & 8.96         & 0.008     \\ \hline
{\bf UPPDxx} & UFxx   & Copper      & Copper of pad plane          & 0.0025    & 8.96         & 0.174     \\
{\bf UPPPxx} & UFxx   & G10         & PCB of pad plane             & 0.0356    & 2.0          & 0.239     \\
{\bf UPGLxx} & UFxx   & Araldite    & Glue on pad plane            & 0.0923    & 1.12         & 0.249     \\
             &        & Araldite    & + additional glue (leaks)    & 0.0505    & 1.12         & 0.107     \\
{\bf UPCBxx} & UFxx   & Carbon      & Carbon fiber mats (x2)       & 0.019     & 1.75         & 0.078     \\
{\bf UPHCxx} & UFxx   & Aramide     & Honeycomb structure          & 2.0299    & 0.032        & 0.169     \\
{\bf UPPCxx} & UFxx   & G10         & PCB of readout boards        & 0.0486    & 2.0          & 0.326     \\
{\bf UPRDxx} & UFxx   & Copper      & Copper of readout boards     & 0.0057    & 8.96         & 0.404     \\
{\bf UPELxx} & UFxx   & Copper      & Electronics and cables       & 0.0029    & 8.96         & 0.202     \\
\end{tabular}
\end{center}
This material budget has been adjusted to match the estimate given 
in~\cite{CLEMENS}, with the exception of the glue layer in the back panel
({\bf UPGLxx}), which has been made thicker to include all the additional
glue that has been applied to fix the gas leaks.  Figure~\ref{FIG_GEO:mat_budget}
shows the resulting radiation length map in the active detector area for
super module 0, which has only carbon fiber inserts at the bottom and is
thus one of the super modules with the largest material budget.  It is
clearly visible that the MCMs and the cooling pipes introduce hots spots
in $X/X_{0}$.  However, after averaging over the shown area, the mean
value is found to be $\langle X/X_{0}\rangle =$~24.7~\%.  For a supermodule
with carbon fiber inserts at the top and the bottom one finds
$\langle X/X_{0}\rangle =$~23.8~\% and in the regions of the PHOS holes (i.e.
in the middle stack of supermodules 13--15) it is only 
$\langle X/X_{0}\rangle =$~1.9~\%.

The total weight of a single TRD super module in the AliRoot geometry, 
including all services, is currently 1595kg, which is ca. 5\% short of its
real weight.  A single ROC of the type L0C1 with electronics and cooling 
pipes weighs 21.82kg.
%
\subsection{Naming Conventions and Numbering Schemes}
%
\begin{figure}[htb]
\begin{minipage}[b]{0.49\textwidth}
\begin{center}
\includegraphics[width=\textwidth]{plots/sector_numbering.eps}
\end{center}
\end{minipage}
\begin{minipage}[b]{0.49\textwidth}
\begin{center}
\includegraphics[width=\textwidth]{plots/layer_numbering.eps}
\vspace{1.4cm}
\end{center}
\end{minipage}
\begin{center}
\includegraphics[width=0.60\textwidth]{plots/stack_numbering.eps}
\end{center}
\caption{
Illustration of the TRD numbering scheme for super modules, defined in
the global ALICE coordinate system: a) {\bf SECTOR} number, b) 
{\bf LAYER} number, c) {\bf STACK} number.
}
\label{FIG_GEO:sm_numbering}
\end{figure}
%
The numbering schemes and the orientations of coordinate systems generally 
follow the official ALICE-TRD definition \cite{DAVID}.  Therefore, the
whole geometry is defined in the global ALICE coordinate system.
%
Inside the code we use the following nomenclature (see 
Fig.~\ref{FIG_GEO:sm_numbering}), which should be used consistently
throughout the TRD code:
%
\begin{center}
\begin{tabular}{l|l|l}
Name          & Definition                                   & Range  \\ \hline
{\bf SECTOR}  & TRD sector in azimuth (i.e. one supermodule) & 0--17  \\
{\bf LAYER}   & Layer inside a supermodule                   & 0--5   \\
{\bf STACK}   & Division of a supermodule along z-direction  & 0--4   \\
{\bf DET}     & Single ROC in whole TRD                      & 0--539 \\ 
{\bf DET-SEC} & Single ROC in one super module               & 0--29 
\end{tabular}
\end{center}
%
Due to the holes in front of the PHOS detector, naturally not all {\bf DET} 
numbers correspond to existing ROCs.  A single ROC can thus be uniquely 
addressed by either using the three numbers 
({\bf LAYER}, {\bf STACK}, {\bf SECTOR}) or the single {\bf DET} number.
The correspondence between the two possibilities is defined as:
\begin{center}
\mbox{{\bf DET} = {\bf LAYER} + {\bf STACK}$\times$5 + {\bf SECTOR}$\times$5$\times$4}
\end{center}
Additionally, there is a number that is unique inside a given super module (i.e. 
sector) and therefore has a range of 0~--~29:
\begin{center}
\mbox{{\bf DET-SEC} = {\bf LAYER} + {\bf STACK}$\times$5}
\end{center}
The class {\tt AliTRDgeometry} provides a set of functions that could/should
be used to convert the one into the other:\\
\hspace*{1.5cm}{\tt AliTRDgeometry::GetDetector(layer,stack,sector)} \\
\hspace*{1.5cm}{\tt AliTRDgeometry::GetDetectorSec(layer,stack)}     \\
\hspace*{1.5cm}{\tt AliTRDgeometry::GetLayer(det)}                   \\
\hspace*{1.5cm}{\tt AliTRDgeometry::GetStack(det)}                   \\
\hspace*{1.5cm}{\tt AliTRDgeometry::GetSector(det)}                  \\
%
\subsection{Pad Planes}
%
All geometric parameters relevant to the pad planes are handled via the
class {\tt AliTRDpadPlane}.  This comprises the dimensions of the pad planes
and the pad themselves, the number of padrows, padcolumns, and their tilting angle.  
The initialization of the needed {\tt AliTRDpadPlane} objects is done in 
{\tt AliTRDgeometry::CreatePadPlaneArray()}.  The number of padrows can be 12 
(C0-type) or 16 (C1-type), the number of padcolumns is 144 in any case.  Again,
the numbering convention follows the definition given in \cite{DAVID}.  Thus,
the padrow numbers in a given pad plane increase from 0 to 11(15) with decreasing
$z$-position, while the padcolumn numbers increase from 0 to 144 with increasing 
$\phi$ angle (i.e. counter clockwise).  The tilting angle of the pads is 2~degrees,
with alternating signs at different layers, beginning with +2~degrees for layer~0.
The class {\tt AliTRDpadPlane} provides a variety of functions that allow to assign 
a pad number (row/column) to signals generated at a given hit position and which
are used during the digitization process.
%
\section{Hit Generation}
%
{\it Author: C.~Blume (blume@ikf.uni-frankfurt.de)}
\smallskip
\\
%
In the case of the TRD a single hit corresponds to a cluster of electrons 
resulting from the ionization of the detector gas.  This ionization can be due
to the normal energy loss process of a charged particle or due to the 
absorption of a transition radiation (TR) photon.  A single TRD hit, as
defined in {\tt AliTRDhit} therefore contains the following data members:
%
\begin{center}
\begin{tabular}{ll}
{\tt fTrack}    & Index of MC particle in kine tree                                        \\
{\tt fX}        & X-position of the hit in global coordinates                              \\
{\tt fY}        & Y-position of the hit in global coordinates                              \\
{\tt fZ}        & Z-position of the hit in global coordinates                              \\
{\tt fDetector} & Number of the ROC ({\bf DET} number)                                     \\
{\tt fQ}        & Number of electrons created in the ionization step. Negative for TR hits \\
{\tt fTime}     & Absolute time of the hit in $\mu$s. Needed for pile-up events            \\
\end{tabular}
\end{center}
%
On top of this, it is also stored in the {\tt TObject} bit field status word  
whether a hit is inside the drift or the amplification region 
(see {\tt AliTRDhit::FromDrift()} and {\tt AliTRDhit::FromAmplification()}).
The creation of hits is steered by {\tt AliTRDv1::StepManager()}.
%
\subsection{Energy loss}
%
A charged particle, traversing the gas volume of the TRD chambers, will release
charge proportional to its specific energy loss.  In the TRD code this process
is implemented in \\{\tt AliTRDv1::StepManager()}.  This implementation used a 
fixed step size.  The standard value here is 0.1~cm, but other values can be
set via {\tt AliTRDv1::SetStepSize()}.  The energy deposited in a given step is
then calculated by the chosen MC program (typically Geant3.21), which after
division by the ionization energy gives the number of electrons of the new hit.
The version 2) will also work for an Ar/CO$_{2}$ mixture, which can be selected
by \\{\tt AliTRDSimParam::SetArgon()}. 
%
\subsection{Photons from transition radiation}
%
Additionally to the hits from energy loss, also hits from the absorbtion of
TR photons are generated.  This is done in {\tt AliTRDv1::CreateTRhit()}, which
in turn is called by the chosen step manager for electrons and positrons
entering the entering the drift volume.  The process consists of two steps:
first the number and energies of the TR photons have to be determined and then
their absorbtion position inside the gas volume has to be calculated.  The
corresponding procedures, used by {\tt AliTRDv1::CreateTRhit()}, are 
implemented in {\tt AliTRDsimTR()}.  This class contains a parametrization
of TR photons generated by a regular foil stack radiator \cite{TRPHOT}.  This
parametrization has been tuned such that the resulting spectrum matches the
one of the fiber radiator that used in reality.  Since the TR production
depends also on the momentum of the electron, the parameters have been 
adjusted in several momentum bins.  After a TR photon has been generated and put
on the particle stack, it is assumed that it follows a straight trajectory 
whose direction is determined by the momentum vector of the generating electron.  
Since the emission angle for TR photons is very small ($\sim 1/\gamma$) this 
is a valid approximation.  The absorbtion length, which thus determines the 
TR hit position, is randomly chosen according to the absorbtion cross sections
in the gas mixture.  These energy dependent cross sections are also included
in {\tt AliTRDsimTR}.
%
\subsection{Track references}
%
The TRD simulation produces track references ({\tt AliTrackReference}) each time 
a charged particle is entering the drift region and exiting the amplification 
region.  These track references thus provide information on the position where 
the MC particle was entering and existing the sensitive region of a ROC, as well
as on its momentum components at this positions.  Also, the index to the MC particle
in the kinematic tree is stored so that the full MC history can be retrieved.
%
\section{Digitization}
%
{\it Author: C.~Blume (blume@ikf.uni-frankfurt.de)}
\smallskip
\\
%
The second step in the simulation chain is the translation of the hit information,
i.e. position and amount of deposited charge, into the final detector response
that can be stored in digits objects ({\tt AliTRDdigits}):
%
\begin{center}
\begin{tabular}{ll}
{\tt fAmp}         & Signal amplitude                      \\
{\tt fId}          & Number of the ROC ({\bf DET} number)  \\
{\tt fIndexInList} & Track index                           \\
{\tt fRow}         & Pad row number                        \\
{\tt fColumn}      & Pad column number                     \\
{\tt fTime}        & Time bin number                       \\
\end{tabular}
\end{center}
%
However, in practise {\tt AliTRDdigits} is not used to store the digits 
information.  Instead the data containers described in \ref{DIGITS:containers}
are used for this purpose.  The digitization process includes as an 
intermediate step between hit and digits the so-called summable digits, or 
sdigits:
\begin{center}
\mbox{{\bf HITS} $\Longrightarrow$ {\bf SDIGITS} $\Longrightarrow$ {\bf DIGITS}}
\end{center}
They sdigits contain the detector signals before discretization and the addition
of noise and are used to merge several events into a single one.
%
\subsection{Digitizer}
%
The class {\tt AliTRDdigitizer} contains all the necessary procedures to convert
hits into sdigits and subsequently sdigits into digits.  The standard sequence to
produce sdigits, as would be initiated by {\tt AliSimulation}, is shown here:
%
\begin{center}
\unitlength1.0cm
\begin{picture}(10,9)
\put(2.5,8.0){\framebox(5.0,0.8){{\tt MakeDigits()}}}
\put(2.5,6.4){\framebox(5.0,0.8){{\tt SortHits()}}}
\put(2.5,4.8){\framebox(5.0,0.8){{\tt ConvertHits(det)}}}
\put(2.5,3.2){\framebox(5.0,0.8){{\tt ConvertSignals(det)}}}
\put(2.5,1.6){\framebox(5.0,0.8){{\tt Signal2SDigits(det)}}}
\put(2.5,0.0){\framebox(5.0,0.8){{\tt TRD.SDigits.root}}}
\put(5.0,8.0){\vector(0,-1){0.8}}
\put(5.0,6.4){\vector(0,-1){0.8}}
\put(5.0,4.8){\vector(0,-1){0.8}}
\put(5.0,3.2){\vector(0,-1){0.8}}
\put(5.0,1.6){\vector(0,-1){0.8}}
\put(5.0,1.2){\line(-1,0){4.0}}
\put(1.0,1.2){\line(0,1){4.8}}
\put(1.0,6.0){\vector(1,0){4.0}}
\put(0.2,6.1){{\tt det=0-539}}
\end{picture}
\end{center}
%
The first function {\tt SortHits()} sorts the simulated hits according to
their {\bf DET} number, so that the digitization procedures can be called
for a single ROCs in the following loop.  The function {\tt ConvertHits()}
does the conversion of the hit information into a detector signal.  In this
procedure each electron of a given hit is in principle followed along its
path from the position of the primary ionization towards the anode wire.
The position of this electron can be modified by diffusion in the gas
({\tt AliTRDdigitizer::Diffusion()}), ExB effect ({\tt AliTRDdigitizer::ExB()}),
and absorbtion ({\tt AliTRDdigitizer::Absorbtion()}, off per default).
The drift time of the electrons is also modified according to their distance
to the corresponding anode wire position ({\tt AliTRDdigitizer::TimeStruct()}),
since the electric field lines are not uniform inside the amplification region.
This results in a non-isochronity of the drift time, which has been
simulated with the GARFIELD program and the tabulated results of this
simulation are used in the digitizing process to adjust the drift times
accordingly. Once the position and the drift time of the electron at the
anode wire plane are know, the signal induced on the pads can be calculated.
This involves three effects: the pad response, which distributes the charge
on several pads ({\tt AliTRDdigitizer::PadResponse()}), the time reponse due 
to the slow ion drift and the PASA response function, which distributes the
charge onto the following time bins, ({\tt AliTRDdigitizer::TimeResponse()}), 
and the cross talk between neighbouring pads ({\tt AliTRDdigitizer::CrossTalk()}).  
At the end of this procedure, the charge seen by each pad in each time bin 
is available.  Also, the indices of maximally three MC particles in the kine
tree contributing to a given pad signal are stored, so that in a later 
analysis it can be tested which particle generated what signal.
As a next step the signals could either directly be converted into {\bf DIGITS},
or, which is the default procedure, they are stored as {\bf SDIGITIS}.
The correponding functions ({\tt AliTRDdigitizer::Signal2SDigits()} and
{\tt AliTRDdigitizer::Signal2ADC()}) are called from 
{\tt AliTRDdigitizer::ConvertSignals()}, depending on the configuation.
The function {\tt AliTRDdigitizer::Signal2SDigits()} stores the signals as 
{\bf SDIGITS} in data structures of the type {\tt AliTRDarraySignal} (see 
section \ref{DIGITS:containers}).  

If desired, the {\bf SDIGITS} can now be added to the {\bf SDIGITS} from other
simulated events, e.g. in order to embed a specific signal into a background
event ({\tt AliTRDdigitizer::MergeSDigits()}). After this optional step, the 
{\bf SDIGITS} are finally being converted into {\bf DIGITS}. This process is
steered by the function ({\tt AliTRDdigitizer::ConvertSDigits()}). 
%
\begin{center}
\unitlength1.0cm
\begin{picture}(10,9)
\put(2.5,8.0){\framebox(5.0,0.8){{\tt Exec()}}}
\put(2.5,6.4){\framebox(5.0,0.8){{\tt SDigits2Digits()}}}
\put(2.5,4.8){\framebox(5.0,0.8){{\tt MergeSDigits()}}}
\put(2.5,3.2){\framebox(5.0,0.8){{\tt ConvertSDigits()}}}
\put(2.5,1.6){\framebox(5.0,0.8){{\tt Signal2ADC(det)}}}
\put(2.5,0.0){\framebox(5.0,0.8){{\tt TRD.Digits.root}}}
\put(5.0,8.0){\vector(0,-1){0.8}}
\put(5.0,6.4){\vector(0,-1){0.8}}
\put(5.0,4.8){\vector(0,-1){0.8}}
\put(5.0,3.2){\vector(0,-1){0.8}}
\put(5.0,1.6){\vector(0,-1){0.8}}
\put(5.0,1.2){\line(-1,0){4.0}}
\put(1.0,1.2){\line(0,1){1.6}}
\put(1.0,2.8){\vector(1,0){4.0}}
\put(0.2,2.9){{\tt det=0-539}}
\end{picture}
\end{center}
%
The essential step in the final {\bf SDIGITS} $\Longrightarrow$ {\bf DIGITS} 
conversion is performed by the function {\tt AliTRDdigitizer::Signal2ADC()}. 
Here pad signals, that are stored as floats, are finally translated into 
integer ADC values. This conversion involves a number of parameters: the pad 
coupling and time coupling factors, the gain of the PASA and of the 
amplification at the anode wire, and the input range and baseline of the ADCs. 
The coupling factors take into account that only a fraction of the incoming 
signal is sampled in the digitization process. At this point also the relative 
gain factors derived from the calibration procedures for a given dataset will 
be used to distort the simulated data correspondingly. The noise is generated 
according to a Gaussian distribution of a given width and added to the output. 
Finally, the converted signals are discretized into the ADC values of the 
defined resolution. At this stage also the zero suppression mechanism is applied 
to the simulated ADC values ({\tt AliTRDdigitizer::ZS()}), in order to reduce 
the output volume (see section \ref{DIGITS:zs}). These {\bf DIGITS} can then 
serve as input to the raw data simulation (see section \ref{RAWSIM}).
%
\subsection{Simulation parameter}
%
The parameters that are needed to configure the digitization, are either
read from the OCDB (e.g. calibration gain factors) or are taken from the
parameter class {\tt AliTRDSimParam}. This class contains the default values
of these parameters, but it can be configured in order to test different 
scenarios. The following table lists the available parameters:
%
\begin{center}
\begin{tabular}{lll}
Parameter              & Description                                   & Default value \\ \hline
{\tt fGasGain}         & Gas gain at the anode wire                    & 4000          \\
{\tt fNoise}           & Noise of the chamber readout                  & 1250          \\
{\tt fChipGain}        & Gain of the PASA                              & 12.4          \\
{\tt fADCoutRange}     & ADC output range (number of ADC channels)     & 1023 (10bit)  \\
{\tt fADCinRange}      & ADC input range (input charge)                & 2000 (2V)     \\
{\tt fADCbaseline}     & ADC intrinsic baseline in ADC channels        & 0             \\
{\tt fElAttachProb}    & Probability for electron attachment per meter & 0             \\
{\tt fPadCoupling}     & Pad coupling factor                           & 0.46          \\
{\tt fTimeCoupling}    & Time coupling factor                          & 0.4           \\ \hline
{\tt fDiffusionOn}     & Switch for diffusion                          & kTRUE         \\
{\tt fElAttachOn}      & Switch for electron attachment                & kFALSE        \\
{\tt fTRFOn}           & Switch for time response                      & kTRUE         \\
{\tt fCTOn}            & Switch for cross talk                         & kTRUE         \\
{\tt fTimeStructOn}    & Switch for time structure                     & kTRUE         \\
{\tt fPRFOn}           & Switch for pad response                       & kTRUE         \\
{\tt fGasMixture}      & Switch for gas mixture (0: Xe/CO2, 1: Ar/CO2) & 0             \\
\end{tabular}
\end{center}
%
\subsection{Digits manager}
\label{DIGITS:manager}
%
{\it Author: H.~Leon~Vargas (hleon@ikf.uni-frankfurt.de)}
\smallskip
\\
%
The class {\tt AliTRDdigitsManager} handles arrays of data container 
objects in the form of ROOT's {\tt TObjArray}.  Its main functionality 
is that it provides setters and getters for the information of each chamber.
%
\begin{figure}[htb]
\begin{center}
\includegraphics[width=0.85\textwidth]{plots/digitsmanager_containers.eps}
\end{center}
\caption{
Data containers used in the class {\tt AliTRDdigitsManager}.
}
\label{FIG_DIG:manager}
\end{figure}
%
\subsection{Data containers}
\label{DIGITS:containers}
%
During simulation different kinds of information are created and stored 
in various data containers depending on their characteristics. 
These containers were designed with the idea of keeping the code as 
simple as possible and to ease its maintenance. 
The simulated signals or sdigits for a given row, column and time bin 
of each detector, as generated by \\ {\tt AliTRDdigitizer::ConvertHits()}, 
are stored in an object of the class {\tt AliTRDarraySignal}.   This 
class stores the data in an array of floating point values.  In this 
case, the compression method takes as an argument a threshold.  All the 
values equal or below that threshold will be set to zero during
compression. The threshold can take any value greater or equal to zero.
The sdigits data is used during event merging.

In the simulation the information about the particles that generated the
hits (index in kine tree) is stored for each detector in an object
of the class {\tt AliTRDarrayDictionary}. In this case the information 
is stored in an array of integer values, which is initialized to -1.
 
In the digitizer, the signals stored in the sdigits are converted 
afterwards into ADC values and kept in objects of the class 
{\tt AliTRDarrayADC}.  This class saves the ADC values in an array of 
short values. The ADC range uses only the first 9 bits, bits 10 to 12 
are used to set the pad status.  An uncompressed object of the class 
{\tt AliTRDarrayADC} should only contain values that are equal or 
greater than -1, because the compression algorithm of this class uses 
all the other negative values in the range of the short data type. The 
value -1 in the data array is used in the simulation to indicate where 
an ADC value was ``zero suppressed''. This is done in this way so we 
are be able to discriminate between real zeroes and suppressed zeroes. 
For the details of the use of pad status refer to the method 
{\tt AliTRDarrayADC::SetPadStatus()} in the implementation file of this class.
%
\subsection{Zero suppression}
\label{DIGITS:zs}
%
{\it Author: H.~Leon~Vargas (hleon@ikf.uni-frankfurt.de)}
\smallskip
\\
%
The zero suppression algorithm was applied at the end of digitization
in order to decrease the size of the digits file. The code is implemented 
in the class {\tt AliTRDmcmSim}.  This algorithm is based on testing 
three conditions on the ADC values of three neighboring pads as seen 
in Fig.~\ref{FIG_DIG:zs} (for more information see the Data Indication 
subsection in the TRAP User Manual). The conditions are the following:\\

1) Peak center detection:\\

ADC-1(t) $\leq$ ADC(t) $\geq$ ADC+1(t)\\

2) Cluster:\\

ADC-1(t)+ADC(t)+ADC+1(t) $>$ Threshold\\

3) Absolute Large Peak:\\

ADC(t) $>$ Threshold\\

If a given combination of these conditions is not fulfilled, the value ADC(t) 
is suppressed. The algorithm runs over all ADC values.
%
\begin{figure}[htb]
\begin{center}
\includegraphics[width=0.60\textwidth]{plots/zsuppression.eps}
\end{center}
\caption{
Zero suppression code.
}
\label{FIG_DIG:zs}
\end{figure}
%
\section{Raw Data Simulation}
\label{RAWSIM}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newpage
\setcounter{chapter}{2}
\setcounter{section}{0}    
\Chapter{Reconstruction}
\thispagestyle{empty}
%
\section{Raw Data Reading}
%
\section{Cluster Finding}
%
\section{Tracking}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newpage
\setcounter{chapter}{3}
\setcounter{section}{0}    
\Chapter{Calibration}
%
{\it Author: R.~Bailhache (rbailhache@ikf.uni-frankfurt.de)}
\smallskip
\\
%
\section{Database Entries}
A local database with default parameters can be found in the AliRoot 
installation directory. The official database is in Alien under the 
directory 
{\tt /alice/data/$\langle$year$\rangle$/$\langle$LHCPeriod$\rangle$/OCDB}. 
The calibration objects are stored in root files named according to their 
run validity range, their version and subversion number. For the TRD they 
are in the subdirectory {\tt \$AliRoot/OCDB/TRD/Calib} and correspond to 
a perfect TRD detector. The parameters are listed in Tab.\ref{entriesdatabase}.\\  
\begin{table} [h]
  \begin{center}
    \begin{tabular}{|c|c|c|c|c|c|}
      \hline Parameter                  & Description                                        & Number of         & Data type  & Unit & Default value \\ 
                                        &                                                    & channels          &            &  &  \\ \hline
      ChamberGainFactor                 & Mean gas gain                                      & 540               & Float      & $-$  & 1.0          \\ 
      $ $                               & per chamber                                        &                   &            &  &          \\ \hline
      LocalGainFactor                   & Gas gain                                           & 1181952           & UShort     & $-$  & 1.0   \\ 
                                        & per pad                                            & 1181952           & UShort     & $-$  & 1.0   \\ \hline
      ChamberVdrift                     & Mean drift velocity                                & 540               & Float      & cm$/$$\mu$s & 1.5 \\ 
                                        & per chamber                                        & 540               & Float      & cm$/$$\mu$s & 1.5 \\ \hline
      LocalVdrift                       & Drift velocity                                     & 1181952           & UShort     & $-$ & 1.0  \\ 
                                        &  per pad                                           & 1181952           & UShort     & $-$ & 1.0  \\ \hline
      ChamberT0                         & Minimum timeoffset                                 & 540               & Float      & timebin  & 0.0   \\ 
                                        & in the chamber                                        & 540               & Float      & timebin  & 0.0   \\ \hline
      LocalT0                           & Timeoffset                                         & 1181952           & UShort     & timebin & 0.0  \\ 
                                        & per pad                                            &                   &            &  &   \\ \hline
      PRFWidth                          & Width of the PRF                                   & 1181952           & UShort     & pad width &  0.515 ( layer 0) \\
      $ $                               & per pad                                            & $ $               & $ $        & $ $       &  0.502 ( layer 1) \\
      $ $                               & $ $                                                & $ $               & $ $        & $ $       &  0.491 ( layer 2) \\
      $ $                               & $ $                                                & $ $               & $ $        & $ $       &  0.481 ( layer 3) \\
      $ $                               & $ $                                                & $ $               & $ $        & $ $       &  0.471 ( layer 4) \\
      $ $                               & $ $                                                & $ $               & $ $        & $ $       &  0.463 ( layer 5) \\ \hline
      DetNoise                          & Scale factor                                       & 540               & Float      & $-$ & 0.1  \\ \hline
      PadNoise                          & Noise                                              & 1181952           & UShort     & ADC  & 12  \\ 
                                        & per pad                                            &                   &            & counts &   \\ \hline
      PadStatus                         & Status                                             & 1181952           & char       & $-$  & $-$   \\ 
                                        & per pad                                            &                   &            &  &   \\ \hline
    \end{tabular}
  \end{center}
\caption{\label{entriesdatabase}Entries in the database}
\end{table}
%
They are related to the calibration of:
\begin{itemize}
\item the gas gain: {\tt ChamberGainFactor} and {\tt LocalGainFactor}
\item the electron drift velocity: {\tt ChamberVdrift} and {\tt LocalVdrift}
\item the timeoffset: {\tt ChamberT0} and {\tt LocalT0}
\item the width of the Pad Response Function: {\tt PRFWidth}
\item the noise per channel: {\tt DetNoise}, {\tt PadNoise} and {\tt PadStatus}.
\end{itemize} 
To save disk space the values per pad are stored in UShort (2 Bytes) 
format in AliTRDCalROC objects, one per chamber, that are members of 
a general {\tt AliTRDCalPad} object. The final constants have a 
numerical precision of 10$^{-4}$. They are computed by 
multiplication (gain, drift velocity and noise) or addition (timeoffset) 
of the detector and pad coefficients. From the pad noise level a status 
is determined for each pad ( masked, bridgedleft, bridgedright, read by 
the second MCM, not connected). One example macro ({\tt AliTRDCreate.C}) 
to produce a local database is given in the {\tt \$AliRoot/TRD/Macros} 
directory.\\
During the simulation of the detector response and the reconstruction 
of the events the parameters are used to compute the amplitude of the 
signal and its position inside the detector. The database has to be 
first choosen with the help of the {\tt AliCDBManager}. The parameters 
are then called by an {\tt AliTRDcalibDB} instance. The macro 
{\tt \$AliRoot/TRD/Macros/ReadCDD.C} shows how to read a local database 
and plot the gas gain or drift velocity as function of the detector 
number or pad number.
%
\section{DAQ Calibration}
Calibration procedures are performed online during data-taking on 
different systems. The principal role of the Data AcQuisition System is 
to build the events and archive the data to permanent storage tapes. In 
addition it also provides an efficient access to the data. Nevertheless 
the complete reconstruction of the events with tracks is not available. 
Two algorithms are executed on DAQ for the TRD: a pedestal algorithm and 
an algorithm for the drift velocity and timeoffset. They are implemented 
as rpm packages, that can be easily built inside AliRoot compiled with 
the DATE software \cite{DATE}. The outputs of the algorithms are stored 
in root files and put on the DAQ File Exchange Server (FXS). At the end 
of the run they are picked up by the so called SHUTTLE and further 
processed in the Preprocessor to fill finally the OCDB. 
\begin{figure}[h]
  \centering\mbox{\epsfig{file=plots/baselinenoisedet0run34510ex.eps,width=0.45\textwidth}}
  \caption{\label{baselinenoisedet0run34510ex}2D histogram of the 
detector 0 (SM 0, S0, L0) with the ADC value distributions around 
the baseline (10 ADC counts) for each pad (PEDESTAL run 34510).}
\end{figure}
\subsection{Pedestal algorithm}
During a pedestal run empty events without zero suppression are taken 
with the TRD alone and a random trigger. They are used to determine 
the noise in ADC counts of each pad. The algorithm can be found in the 
{\tt TRDPEDESTALda.cxx} file of the AliRoot TRD directory. It is 
executed on the Local Data Concentrators (LDCs), which are part of the 
dataflow and gives access to sub-events. The TRD has three LDCs 
corresponding to the following blocks of supermodules (SMs):
\begin{itemize}
\item 0-1-2-9-10-11
\item 3-4-5-12-13-14
\item 6-7-8-15-16-17
\end{itemize}   
Three algorithms are therefore executed in parallel during a PEDESTAL 
run for a full installed TRD. After about 100 events, the data-taking 
stops automatically and a 2D histogram is filled for each chamber with 
the ADC amplitude distributions around the baseline for each pad. Such 
a histogram is shown in Fig.\ref{baselinenoisedet0run34510ex} for 
chamber 0 (SM 0 Stack 0 Layer 0).
\begin{figure}[h]
  \centering\mbox{\epsfig{file=plots/run38125sm0nounfold.eps,width=0.88\textwidth,height=0.55\textwidth}}
  \caption{\label{run38125sm0nounfold}Noise in the six planes of 
SM 0 (PEDESTAL run 38125). The five stacks in each layer are in 
the {\it{z}} direction.}
\end{figure}
The chambers should be so configured that the data is without zero 
suppression otherwise an error message appears on the DAQ online 
Logbook. The container class is called {\tt AliTRDCalibPadStatus} 
and allows to further fit the distributions with a Gaussian to 
determine the baseline and noise of each pad. The function is called 
{\tt AliTRDCalibPadStatus::AnalyseHisto()}. In 
Fig.\ref{run38125sm0nounfold} the noise in SM 0 is plotted for the 
PEDESTAL run 38125. It shows stripe patterns of higher noise in the 
$z$-direction (beam direction) correlated to the static pad capacitance 
of the pad plane. The noise distributions has to be first corrected 
for the expected noise variations induced by the pad capacitance 
before a status can be given to each pad. This is not done on the DAQ 
but just before storing the parameters inside the Offline Condition 
Database (OCDB) in the Preprocessor.

\subsection{Drift velocity and timeoffset algorithm}
The drift velocity and timeoffset are calibrated with physics events, 
$pp$ or $PbPb$ collisions. The algorithm is called 
{\tt TRDVDRIFTda.cxx} and can be found in the AliRoot TRD directory. 
It is executed on a dedicated monitoring server, which is not part 
of the dataflow and gives access to full events of the TRD. The 
physics events are used to fill continuously during data-taking an 
average pulse height for each detector. They are stored in a 
{\tt TProfile2D}, which is a member of a { \tt AliTRDCalibraFillHisto} 
object. The {\tt TProfile2D} is written at the end of the run in a 
root file put on the DAQ FXS.\\
\begin{figure}[h]
  \centering\mbox{\epsfig{file=plots/referenceph2d.eps,width=0.6\textwidth,,height=0.5\textwidth}}
  \caption{\label{referenceph2d}2D histogram containing the average 
pulse height distributions of each calibration group (here detector), 
produced with decalibrated simulated $pp$ events.}
\end{figure}

Fig.\ref{referenceph2d} shows an output {\tt TProfile2D} obtained 
from simulated decalibrated $pp$ collisions at 14\,TeV. The first 
peak in time corresponds to the amplification region, where the 
contributions of ionization electrons, which come from both sides 
of the anode wire plane, are overlapping. The flat plateau results 
from the electrons in the drift region. The tail is caused by the 
Time Response Function. From this average signal as function of time 
the drift velocity and timeoffset can be extracted by fit procedures. 
This last step is performed in the Preprocessor.\\
Since no tracking is available on DAQ, a simple tracklet finder is 
used. It was optimized for a low charged particle multiplicity 
environment. The algorithm looks for a maximum of the signal 
amplitudes in the chamber after integration over all timebins. The 
average pulse height is then filled for a spot of two pad rows 
($z$ direction) and four pad columns ($r\phi$ direction) around the 
maximum. Further details can be found in the function 
{\tt AliTRDCalibraFillHisto::ProcessEventDAQ}.
%
\section{HLT Calibration}
The High Level Trigger has the big advantage to provide an online 
reconstruction of the events. The idea is then to run the calibration 
procedures in a transparent way, independent whether online or 
offline. The same function 
\\{\tt AliTRDCalibraFillHisto::UpdateHistogramsV1(AliTRDtrackV1 *t)} 
is used to fill the $dE/dx$ distributions (gain), the average pulse 
height (drift velocity and timeoffset) and the Pad Response Function 
for each detector in respectively one {\tt TH2I} and two 
{\tt TProfile2Ds}. The calibration is nevertheless done per chamber, 
whereas by integrating statistics it will be possible to get the gain, 
drift velocity and timeoffset distributions inside the chambers offline. 
Therefore the class {\tt AliTRDCalibraFillHisto} contains a flag 
({\tt fIsHLT}) to avoid extra calculations not needed at the detector 
level.\\
\begin{figure}[hbt]
  \centering\mbox{\epsfig{file=plots/referencech2d.eps,width=0.55\textwidth,,height=0.45\textwidth}}
  \caption{\label{referencech2d}A 2D histogram containing the 
$dE$$/$$dx$ distributions of each detector. These were produced 
with decalibrated simulated $pp$ events.}
\end{figure}

Fig.\ref{referencech2d} shows one example of a {\tt TH2I} histogram, 
where the $dE/dx$ distributions of each detector is stored for $pp$ 
collisions at 14\,TeV. No minimal $p_{T}$ cut was applied on the 
TRD tracks. Assuming that the charged particles are uniformy 
distributed over the TRD chambers, the position of the Most Probable 
Value of the $dE/dx$ distribution is used to calibrate the gain.\\ 
At the beginning of each run, a local copy of the OCDB is updated 
on the HLT cluster: the HCDB (HLT Condition Database). The last set 
of calibration objects are used to reconstruct the events. The gain 
correction preformed during the tracking has to be taken into account 
when filling the $dE/dx$ distributions. That is why the calibration 
algorithm has to know which database was used during the 
reconstruction. The TRD HLT code can be found in the {\tt HLT/TRD} 
subdirectory of the AliRoot installation. The calibration is 
implemented as an {\tt AliHLTTRDCalibrationComponent}, whose members 
are an {\tt AliCDBManager} together with the path for the current 
database used, and an {\tt AliTRDCalibraFillHisto} object. The main 
functions are:
\begin{itemize}
\item {\tt AliHLTCalibrationComponent::InitCalibration}, where the 
{\tt TH2I} and {\tt TProfile2Ds} are created.
\item {\tt AliHLTCalibrationComponent::ProcessCalibration}, where 
the function\\ 
{\tt AliTRDCalibraFillHisto::UpdateHistogramsV1(AliTRDtrackV1 *t)} 
is called to fill the histograms.
\item {\tt AliHLTCalibrationComponent::FormOutput}, which returns 
a {\tt TObjArray} with the histograms.
\end{itemize}     
The histograms are shipped at the end of each run to the HLT File 
Exchange Server to be picked up by the SHUTTLE and further processed 
by the Preprocessor, exactly as the data from the calibration on DAQ.
%
\section{Preprocessor}
%
The online systems, like the Detector Control System (DCS), the DAQ 
and the HLT, are protected from outside by a firewall. A special 
framework, called the SHUTTLE, has been developped to retrieve offline 
data in the online systems or store relevant information from the 
online systems in the OCDB. The SHUTTLE has access to the DCS, DAQ 
and HLT FXS. At the end of each run the reference data, outputs of 
the calibration algorithms on DAQ and HLT, are retrieved and further 
processed to determine the calibration constants (gain, drift velocity, 
timeoffset and width of the Pad Response Function). The reference 
data are finally stored in the Grid reference Data Base, whereas the 
results of the fit procedures are stored in the OCDB.\\
The code is contained in the {\tt AliTRDPreprocessor} class. The 
Process function is executed for the run types: PEDESTAL, STANDALONE, 
DAQ and PHYSICS.
\begin{itemize}
\item The PEDESTAL run are dedicated to the calibration of the noise 
on DAQ. Only the output of the DAQ pedestal algorithm is retrieved at 
the SHUTTLE. From the noise and baseline of each pad, a pad status is 
determined. Disconnected pads are recognizable by a small noise. 
Bridged pads have the same noise and baseline. The noise and 
padstatus of the previous pedestal run in the OCDB are taken for half 
chambers, which were not On. Finally the database entries 
{\tt DetNoise}, {\tt PadNoise} and {\tt PadStatus} are populated in 
the OCDB. More informations can be found in the function 
\\{\tt AliTRDPreprocessor::ExtractPedestals}.
\item The STANDALONE runs are used to check the data integrity or the 
correlated noise. The data are taken with the TRD alone and a random 
trigger. Only the DCS data are retrieved.
\item The DAQ run are test runs for the DAQ people. Only the DCS data 
are retrieved.
\item The PHYSICS run are global runs including more than one detector 
and different trigger clusters. They are used for the calibration of 
the gain, driftvelocity and timeoffset, and width of the PRF. Therefore 
the output of the calibration algorihms running on HLT are retrieved. 
If the procedure is not successful the output of the 
driftvelocity$/$timeoffset algorithm on DAQ is also retrieved. The 
reference data, the histograms, are fitted using an 
{\tt ALiTRDCalibraFit} instance:
\begin{itemize}
\item {\tt AliTRDCalibraFit::AnalyseCH(const TH2I *ch)} determines 
the MPVs of the $dE/dx$ distributions and compares them to a reference 
value.
\item {\tt AliTRDCalibraFit::AnalysePH(const TProfile2D *ph)} fits 
the average pulse height and determines the position of the amplification 
region peak and the end of the drift region for each chamber. Knowing 
the length of the drift region one can deduce the drift velocity. The 
amplification peak gives also information on the timeoffset.   
\item {\tt AliTRDCalibraFit::AnalysePRFMarianFit(const TProfile2D *prf)} 
determines the spread of the clusters as function of azimuthal angle of 
the track. The minimum gives the width of the PRF.
\end{itemize}
The results of each fit procedure are stored in a {\tt TObjArray} of 
\\{\tt AliTRDCalibraFit::AliTRDFitInfo} objects, one per chamber, which 
is a member of the {\tt AliTRDCalibraFit} instance. The functions 
{\tt AliTRDCalibratFit::CreateDetObject*} and {\tt ::CreatePadObject*} 
allow to create from the {\tt TObjArray} the final calibration objects, 
that have to be put in the OCDB.
\end{itemize}
Tab.\ref{taskruntype} summarizes the tasks executed by the prepocessor 
for each run type.
\begin{table}[h]
\begin{center}
\begin{tabular} {|c|c|c|c|c|}
\hline run type & DCS data points  & DCS FXS & DAQ FXS & HLT FXS  \\
 & temperatures  & electronic  & calibration DA  & calibration DA   \\
 & voltages, etc $\cdots$  &  configuration & noise/($v_{dE}$$/$$t_{0}$)  
& $g$/($v_{dE}$$/$$t_{0}$)/$\sigma_{PRF}$   \\
\hline DAQ   & yes & yes & no & no \\\hline
\hline PEDESTAL   & no & no & yes (noise) & no \\\hline
\hline STANDALONE & yes & yes & no & no \\\hline
\hline PHYSICS & yes & yes & yes ($v_{dE}$$/$$t_{0}$) & yes \\\hline
\end{tabular} 
\caption{\label{taskruntype} Tasks performed by the TRD preprocessor 
for every run type.} 
\end{center}
\end{table}
The DCS data points are measurements of the currents, voltages, 
temperatures and other variables of the chambers as function of time. 
They are saved in the DCS Archive DB during the run and made available 
at the SHUTTLE by AMANDA.
%
\section{Offline Calibration}
The offline calibration of the gain, driftvelocity$/$timeoffset and 
width of the PRF is meant to improve the first calibration online. 
It follows the following steps:
\begin{itemize}
\item Fill reference data (the $dE/dx$ distributions, the average 
pulse heights $\cdots$) during the reconstruction of the events offline.
\item Store the reference data in root files in AliEn.
\item Merge the reference data of different runs and$/$or calibration groups.
\item Fit the reference data to extract the calibration constants and 
create the calibration objects.
\item Store the calibration objects according to their run validity in 
the OCDB.
\end{itemize}
The calibration procedure is not performed per detector anymore but per 
pad, at least for the first step, the filling of the reference data. 
Depending on the available statics the reference data of different pads 
(calibration groups) can be merged together to determine a mean 
calibration coefficient over these pads.
\subsection{AliTRDCalibraVector container}
The high granularity of the calibration, with a total number of 1181952 
pads, implies that the size of the reference data has to be reduced to 
the strict minimum needed.
\begin{table}[h]
\begin{center}
\begin{tabular} {|c|c|c|}
\hline reference data & Number of  & size  \\
 for & calibration groups  & in MB   \\\hline
 gain & 1181952 & 225 \\\hline
 driftvelocity$/$timeoffset & 1181952 & 271 \\\hline
 PRF  & 131328  & 200 \\\hline
 All together & & 696 \\\hline
\end{tabular} 
\caption{\label{sizeofAliTRDCalibraVector} Size of the 
{\tt AliTRDCalibraVector} object for a given granularity.} 
\end{center}
\end{table}

The {\tt TH2I} and {\tt TProfile2D} objects are not a good option 
anymore. Therefore a container class, {\tt AliTRDCalibraVector}, was 
developped. The {\tt TH2I} corresponds to an array of UShort (2 Bytes) 
for the number of entries in each bin, the {\tt TProfile2D} to an array 
of UShort for the number of entries in each bin and two arrays of Float 
for the sum of the weights and the sum of the squared weights in each 
bin. The mean value and its error are computed per hand in the functions 
{\tt AliTRDCalibraVector::UpdateVector*}, where the object is filled 
with new data. The size of the {\tt AliTRDCalibraVector} object is 
summarized in Tab.\ref{sizeofAliTRDCalibraVector}.\\
%
\subsection{Additional method to calibrate the drift velocity}
In addition an other method is available for the calibration of the 
drift velocity. It is based on the comparison of the slope of the TRD 
tracklet in the azimuthal plane $xy$ with the $\phi$ angle of the 
global track. It can be shown that the slope $dy/dt$ of a TRD tracklet 
depends linearly on its global track parameters, 
$\tan(\phi)+(dz/dx)\tan(\beta_{tilt})$ \cite{THESISR}. The slope 
parameter is the drift velocity in the electric field direction, 
whereas the constant gives the tangent of the Lorentz angle. If the 
TRD tracklet crosses two different pads in the $z$ direction (the 
beam direction), the relation is not true anymore. Therefore such 
tracklets are rejected in the calibration procedure. The reference 
data are a {\tt TObjArray} of one {\tt TH2F} histogram for each 
detector.\\
\begin{figure}[hbt]
  \centering\mbox{\epsfig{file=plots/crossrow.eps,width=0.5\textwidth,height=0.45\textwidth}}
  \caption{\label{crossrow}The correlation between $dy/dt$ and 
$\tan(\phi)+(dz/dx)\tan(\beta_{tilt})$ for the reconstructed track 
in one chamber. The tracks crossing at least two pad rows are in 
red crosses and those crossing one pad row in blue points.}
\end{figure}

Fig.\ref{crossrow} shows one example of such a histogram. They are 
filled in the function 
\\{\tt AliTRDCalibraFillHisto: :UpdateHistogramsV1(AliTRDtrackV1 *t)}, 
like the reference data for other calibration constants, if the 
flag {\tt fLinearFitterDebugOn} is true.\\
The histograms are stored in the container class, 
\\{\tt AliTRDCalibraVdriftLinearFit}, for which a {\tt Merge} and 
{\tt Add} function have been implemented. In a second step, the 
{\tt AliTRDCalibraVdriftLinearFit} objects can be merged together 
for different runs. In a third step, the {\tt TH2F} histograms are 
fitted in the function \\{\tt AliTRDCalibraVdriftLinearFit::FillPEArray}. 
The result parameters are members of the 
{\tt AliTRDCalibraVdriftLinearFit} object, as well as their error 
coming from the fit procedures. Finally the 
{\tt AliTRDCalibraVdriftLinearFit} object is passed to an 
{\tt AliTRDCalibraFit} instance through the function 
{\tt AliTRDCalibraFit::AnalyseLinearFitters}, in which the Lorentz 
angle is computed from the fit parameters and stored together with 
the drift velocity in a {\tt TObjArray}, member of the 
{\tt AliTRDCalibraFit} instance. As for the other calibration 
constants the functions {\tt AliTRDCalibratFit::CreateDetObject*} 
and {\tt ::CreatePadObject*} allows to create the final calibration 
objects, that have to be put in the OCDB. Since the Lorentz angle 
is not a OCDB entries, it is only used for debugging.
%       
\subsection{The calibration AliAnalysisTask}
The reference data of the calibration are filled in an AliAnalysisTask 
during the reconstruction or after the reconstruction. Since it needs 
some informations only stored in the AliESDfriends, they have to be 
written if one wants to run the calibration. This will be the case 
only for TRD track above a given $p_{T}$ since the size of the events 
is otherwise to big.
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newpage
\setcounter{chapter}{4}
\setcounter{section}{0}    
\Chapter{Alignment}
\thispagestyle{empty}
%
\section{???}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newpage
\setcounter{chapter}{5}
\setcounter{section}{0}    
\Chapter{Quality Assurance (QA)}
\thispagestyle{empty}
%
\section{???}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newpage
\setcounter{chapter}{6}
\setcounter{section}{0}    
\Chapter{High Level Trigger (HLT)}
\thispagestyle{empty}
%
\section{???}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newpage
\setcounter{chapter}{7}
\setcounter{section}{0}    
\Chapter{References}
\thispagestyle{empty}
%
\begin{thebibliography}{99}
%
\bibitem{ALIROOT}  {\it The ALICE Offline Bible}\\
                   http://aliceinfo.cern.ch/export/sites/AlicePortal/Offline/galleries/Download/OfflineDownload/ \\
                   OfflineBible.pdf.
%
\bibitem{CLEMENS}  C.~Adler,
                   {\it Radiation length of the ALICE TRD}
%
\bibitem{DAVID}    D.~Emschermann,
                   {\it Numbering Convention for the ALICE TRD Detector.},
                   http://www.physi.uni-heidelberg.de/\~demscher/alice/numbering/more/TRD\_numbering\_v04.pdf.
%
\bibitem{TRPHOT}   M.~Castellano et al.,
                   Comp. Phys. Comm. {\bf 55}, 431 (1988),
                   Comp. Phys. Comm. {\bf 61}, 395 (1990),
%
\bibitem{DATE}     K.~Schossmaier et al.,
                   {\it The Alice Data Acquisition and Test Environment DATE V5}, 
                   CHEP06.
%
\bibitem{THESISR}  R.~Bailhache, 
                   {\it Calibration of the ALICE Transition Radiation Detector 
                   and a study of $Z^{0}$ and heavy quark production in $pp$ 
                   collisions at the LHC},
                   PhD thesis, University of Darmstadt (Germany), 2009.
%
\end{thebibliography}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
\end{document}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%