Fork me on GitHub

source: svn/trunk/paper/notes.tex@ 113

Last change on this file since 113 was 113, checked in by Xavier Rouby, 16 years ago

partial update

File size: 26.9 KB
Line 
1\documentclass[a4paper,11pt,oneside,onecolumn]{article}
2%\usepackage[english]{babel}
3\usepackage[ansinew]{inputenc}
4\usepackage{abstract}
5
6\usepackage{amsmath}
7\usepackage{epic}
8 \usepackage{wrapfig}
9\usepackage{eepic}
10\usepackage{color}
11\usepackage{latexsym}
12\usepackage{array}
13\usepackage{multicol}
14
15\usepackage{fancyhdr}
16\usepackage{verbatim}
17\addtolength{\textwidth}{2cm} \addtolength{\hoffset}{-1cm}
18\usepackage[colorlinks=true, pdfstartview=FitV, linkcolor=black, citecolor=black, urlcolor=black, unicode]{hyperref}
19\usepackage{ifpdf}
20\usepackage{cite}
21
22\newcommand{\dollar}{\$}
23
24\ifpdf
25 \usepackage[pdftex]{graphicx}
26 \graphicspath{{all_png/}}
27 \pdfinfo{
28 /Author (S. Ovyn, X. Rouby)
29 /Title (Delphes, a framework for fast simulation of a general purpose LHC detector)
30 /Subject ()
31 /Keywords (Delphes, Fast simulation, LHC, FROG, Hector, Smearing, FastJet)}
32\else
33 \usepackage[dvips]{graphicx}
34 \graphicspath{{figures/}}
35\fi
36
37\title{\textsc{Delphes}, a framework for fast simulation \\of a general purpose LHC detector}
38\author{S. Ovyn and X. Rouby\thanks{Now in Physikalisches Institut, Albert-Ludwigs-Universit\"at Freiburg} \\
39 Center for Particle Physics and Phenomenology (CP3)\\ Universit\'e catholique de Louvain \\ B-1348 Louvain-la-Neuve, Belgium \\ \\
40 \textit{severine.ovyn@uclouvain.be, xavier.rouby@cern.ch} \\
41}
42\date{}
43
44\begin{document}
45
46
47\maketitle
48
49Knowing whether theoretical predictions are visible and measurable in a high energy experiment is always delicate, due to the
50complexity of the related detectors, data acquisition chain and software. We introduce here a new framework, \textsc{Delphes}, for fast simulation of
51a general purpose experiment. The simulation includes a tracking system, embedded into a magnetic field, calorimetry and a muon
52system, and possible very forward detectors arranged along the beamline.
53The framework is interfaced to standard file formats (e.g. Les Houches Event File) and outputs observable analysis data objects, like missing transverse energy and collections of electrons or jets.
54The simulation of detector response takes into account the detector resolution, and usual reconstruction algorithms for complex objects, like \textsc{FastJet}. A simplified preselection can also be applied on processed data for trigger emulation. Detection of very forward scattered particles relies on the transport in beamlines with the \textsc{Hector} software. Finally, the \textsc{Frog} 2D/3D event display is used for visualisation of the collision final states.
55An overview of \textsc{Delphes} is given as well as a few use-cases for illustration.
56\vspace{1cm}
57
58\noindent
59\textit{Keywords:} \textsc{Delphes}, fast simulation, LHC, smearing, trigger, \textsc{FastJet}, \textsc{Hector}, \textsc{Frog}
60\vspace{1cm}
61
62%\saythanks
63
64\section{Introduction}
65% Motiver l'utilisation d'un simulateur rapide
66% - 1) rapide VS lent
67% - 2) relativement bonne prédiction en premiÚre approximation
68% - 3) permet de comparer
69
70Experiments at high energy colliders are very complex systems, in several ways. First, in terms of the various detector subsystems, including tracking, central calorimetry, forward calorimetry, and muon chambers, with different principles, technologies, geometries and sensitivities. Then, due to the requirement of a highly effective online selection (i.e. a \textit{trigger}) which is subdivided into several levels for an optimal reduction factor, but based only on partial data. Finally, in terms of the experiment software with different data format (like \textit{raw} or \textit{reconstructed} data), many reconstruction algorithms and particle identification schemes.
71
72This complexity is handled by large collaborations of thousands of people, which restrict the availability of the data, software and documentation to their members. Real data analyses require a full detector simulation, including the various detector inefficiencies, the dead material, the imperfections and the geometrical details. Moreover, detector calibration and alignment are crucial. Such simulation is very complicated, technical and slow. On the other hand, phenomenological studies, looking for the observability of given signals, may require only fast but realistic estimates of the observables.
73
74A new framework, called \textsc{Delphes}~\cite{bib:Delphes}, is introduced here, for the fast simulation of a general purpose collider experiment.
75Using the framework, observables can be estimated for specific signal and background channels, as well as their production and measurement rates, under a set of assumptions.
76Starting from the output of event generators, the simulation of the detector response takes into account the subdetector resolutions, by smearing the kinematical properties of the visible final particles. Tracks of charged particles and calorimetric towers are then created.
77
78\textsc{Delphes} includes the most crucial experimental features, like (1) the geometry of both central or forward detectors; (2) lepton isolation; (3) reconstruction of photons, leptons, jets, $b$-jets, $\tau$-jets and missing transverse energy; (4) trigger emulation and (5) an event display (Fig.~\ref{fig:FlowChart}).
79
80\begin{figure}[!h]
81\begin{center}
82\includegraphics[width=\columnwidth]{FlowDelphes}
83\caption{Flow chart describing the principles behind \textsc{Delphes}.}
84\label{fig:FlowChart}
85\end{center}
86\end{figure}
87
88Although this kind of approach yields much realistic results than a simple ``parton-level" analysis, a fast simulation comes with some limitations. Detector geometry is idealised, being uniform, symmetric around the beam axis, and having no craks nor dead material. Secondary interactions, multiple scatterings, photon conversion and bremsstrahlung are also neglected.
89%
90
91
92The simulation package proceeds in two stages. The first part is executed on the generated events. ``Particle-level" informations are read from input files and stored in a {\it \textsc{gen}} \textsc{root} tree. Three varieties of input files can currently be used as input in \textsc{Delphes}. In order to process events from many different generators, the standard Monte Carlo event structure StdHep can be used as an input. Besides, \textsc{Delphes} can also provide detector response for events read in "Les Houches Event Format" (\textsc{lhef}) and \textsc{root} files obtained using the {\bf h2root} converter program. This first stage is performed using three C++ classes: {\verb HEPEVTConverter }, {\verb LHEFConverter } and {\verb STDHEPConverter }.
93Afterwards, \textsc{Delphes} performs a simple trigger simulation and reconstruct "high-level objects". These informations are organised in classes and each objects are ordered with respect to the transverse momentum. The output of the various C++ classes is stored in the {\it Analysis} tree. The program is driven by a datacard (data/DataCardDet.dat) which allow a large spectrum of running conditions by modifying basic detector parameters, including calorimeter and tracking coverage and resolution, thresholds or jet algorithm parameters.\\
94
95Usual algorithms are applied for the reconstruction of complex objects, like the missing transverse energy or the jets originating from $b$ quarks or $\tau$ leptons.
96
97A simplified preselection can also be applied on processed data for trigger emulation.
98All detectors are assumed to be symmetric with respect to the beam axis
99\section{Central detector simulation}
100
101\begin{figure}[!h]
102\begin{center}
103\includegraphics[width=\columnwidth]{Detector_Delphes_1}
104\caption{Layout of the generic detector geometry assumed in \textsc{Delphes}. The innermost layer, close to the interaction point, is a ce
105ntral tracking system (pink). It is surrounded by a central calorimeter volume (green) with both electromagnetic and hadronic sections. Th
106e outer layer of the central system (red) consist of a muon system. In addition, two end-cap calorimeters (blue) extend the pseudorapidity
107 coverage of the central detector. The actual detector granularity and extension is defined in the user-configuration card. The detector i
108s assumed to be strictly symmetric around the beam axis (black line). Additional forward detectors are not depicted.}
109\label{fig:GenDet}
110\end{center}
111\end{figure}
112
113\begin{figure}[!h]
114\begin{center}
115\includegraphics[width=0.5\columnwidth]{Detector_Delphes_3}
116\caption{Profile of the layout assumed in \textsc{Delphes}. The extension of the various subdetectors, as defined in Tab.~\ref{tab:defEta}
117, are clearly visible. Same colour codes as for Fig.~\ref{fig:GenDet} are applied. Additional forward detectors are not depicted.}
118\label{fig:GenDet3}
119\end{center}
120\end{figure}
121
122\begin{figure}[!h]
123\begin{center}
124\includegraphics[width=0.6\columnwidth]{Detector_Delphes_2b}
125\caption{Layout of the generic detector geometry assumed in \textsc{Delphes}. Open 3D-view of the detector with solid volumes. Same colour codes as for Fig.~\ref{fig:GenDet} are applied. Additional forward detectors are not depicted.}
126\label{fig:GenDet2}
127\end{center}
128\end{figure}
129
130
131The overall layout of the general purpose detector simulated by \textsc{Delphes} is shown in figure \ref{fig:GenDet}. A central tracking system surrounded by an electromagnetic and a hadron calorimeters. A forward calorimeter ensures a larger geometric coverage for the measurement of the missing transverse energy. The fast simulation of the detector response takes into account geometrical acceptance of sub-detectors and their finite resolution.
132
133\textcolor{red}{No smearing is applied on particle direction. (???)}\\
134
135Before starting to loop over events, the {\verb RESOLution } class loads all sub-detector resolutions and coverage from the detector parameter file. If no such file is provided, predifined values are used. The coverage of the various sub-systems used in the default configuration are summarized in table \ref{tab:defEta}.
136
137\begin{table}[!h]
138\begin{center}
139\begin{tabular}[!h]{lll}
140\hline
141Tracking & {\verb CEN_max_tracker } & 2.5\\
142Calorimeters & {\verb CEN_max_calo_cen } & 3.0\\
143 & {\verb CEN_max_calo_fwd } & 5.0\\
144Muon & {\verb CEN_max_mu } & 2.4\\\hline
145\end{tabular}
146\label{tab:defEta}
147\end{center}
148\end{table}
149
150\subsection{Simulation of calorimeters response}
151
152The energy of all particle considered as stable in the generator particle list are smeared according to a resolution depending which sub-calorimeter is assumed to be used for the energy measurement. For particles with a short lifetime such as the $K_s$, the fraction of electromagnetic or hadronic energy is determined according to its decay products. The response of the each sub-calorimeter is parametrized as a function of the energy
153\begin{equation}
154\frac{\sigma}{E} = \frac{S}{\sqrt{E}} \oplus \frac{N}{E} \oplus C,
155\end{equation}
156where S is the stochastic term, N the noise and C the constant term.\\
157
158The response of the detector is applied to the electromagnetic and the hadronic particles through the {\verb SmearElectron }and {\verb SmearHadron } functions. The 4-momentum $p^\mu$ are smeared with a parametrisation directly derived from the detector techinal designs. In the default parametrisation, the calorimeter is assumed to cover the pseudorapidity range $|\eta|<3$ and consists in an electromagnetic and an hadronic part. Coverage between pseudorapidities of 3.0 and 5.0 is provided by a forward calorimeter. The response of this calorimeter can be different for electrons and hadrons. The default values of the stochastic, noisy and constant terms as well as the ``Card flag" names used in the configuration file are given in table \ref{tab:defResol}.\\
159
160\begin{table}[!h]
161\begin{center}
162\begin{tabular}[!h]{lclc}
163\hline
164\multicolumn{2}{c}{Resolution Term} & Card flag & Value\\\hline
165Central \textsc{ecal} & S & {\verb ELG_Scen } & 0.05 \\
166 & N & {\verb ELG_Ncen } & 0.25 \\
167 & C & {\verb ELG_Ccen } & 0.0055 \\
168Forward \textsc{ecal} & S & {\verb ELG_Sfwd } & 2.084 \\
169 & N & {\verb ELG_Nfwd } & 0.0 \\
170 & C & {\verb ELG_Cfwd } & 0.107 \\
171Central \textsc{hcal} & S & {\verb HAD_Shcal } & 1.5 \\
172 & N & {\verb HAD_Nhcal } & 0.\\
173 & C & {\verb HAD_Chcal } & 0.05\\
174Forward \textsc{hcal} & S & {\verb HAD_Shf } & 2.7\\
175 & N & {\verb HAD_Nhf } & 0. \\
176 & C & {\verb HAD_Chf } & 0.13\\
177\hline
178\end{tabular}
179\label{tab:defResol}
180\end{center}
181\end{table}
182
183The energy of electron and photon particles found in the particle list are smeared using the \textsc{ecal} resolution terms. Charged and neutral final state hadrons interact with the \textsc{ecal}, \textsc{hcal} and the forward calorimeter. Some long-living particles, such as the $K_s$, possessing lifetime $c\tau$ smaller than 10~mma are considering as stable particles although they decay in the calorimeters. The energy smearing of such particles is performed using the expected fraction of the energy, determined according to their decay products, that whould be deposited into the \textsc{ecal} ($E_{ecal}$) and into the \textsc{hcal} ($E_{hcal}$). Defining $F$ as the fraction of the energy leading to a \textsc{hcal} deposit, the two energy values are given by
184\begin{equation}
185E_{hcal} = E \times F ~\mathrm{and}~ E_{ecal} = E \times (1-F),
186\end{equation}
187where $0 \leq F \leq 1$. The electromagnetic part is handled as the electrons, while the resolution terms used for the hadronic part are {\verb HAD_Shcal }, {\verb HAD_Nhcal } and {\verb HAD_Chcal }. The resulting final energy given after the application of the smearing is then $E = E_{hcal} + E_{ecal}$.\\
188
189
190\subsection{Muon smearing}
191
192Muons candidates are searched
193The smearing ot the muon 4-momentum $p^\mu$ is given by a Gaussian smearing of the $p_T$ function \texttt{SmearMuon}. Only the $p_T$ is smeared, but neither $\eta$ nor $\phi$.
194
195\subsection{Tracks reconstruction}
196
197All stable charged particles lying inside the fiducial volume of the tracking coverage provide a track. The reconstructio efficiency is manageable in the input datacard through the {\verb TRACKING_EFF } term. By default, a track is assumed to be reconstructed with $90\%$ probability.
198
199\subsection{Calorimetric towers}
200
201All undecayed particles, except muons and neutrinos are producing a calorimetric tower. The same particles enter in the calculation of the missing transverse energy. \textit{what is used is the particle smeared momentum, not the calorimetric towers!}
202
203\subsection{Isolated lepton reconstruction}
204
205Photon and electron candidates are reconstructed if they fall into the acceptance of the tracking system and have a transverse momentum above the {\verb ELEC_pt } value (10~GeV by default). Muons candidates are searched
206
207Lepton isolation demands that there is no other charged particles with $p_T>2$~GeV within a cone of $\Delta R<0.5$ around the lepton.\\
208
209\subsection{Very forward detectors simulation}
210
211Some subdetectors have the ability to measure the time of flight of the particle. This correspond to the delay after which the particle is observed in the detector, after the bunch crossing. The time of flight measurement of ZDC and FP420 detector is implemented here. For the ZDC, the formula is simply
212\begin{equation}
213 t_2 = t_1 + \frac{1}{v} \times \big( \frac{s-z}{\cos \theta}\big),
214\end{equation}
215where $t_2$ is the time of flight, $t_1$ is the true time coordinate of the vertex from which the particle originates, $v$ the particle velocity, $s$ is the ZDC distance to the interaction point, $z$ is the longitudinal coordinate of the vertex from which the particle comes from, $theta$ is the particle emission angle. This assumes that the neutral particle observed in the ZDC is highly relativistic, i.e. travelling at the speed of light $c$. We also assume that $\cos \theta = 1$, i.e. $\theta \approx 0$ or equivalently $\eta$ is large. As an example, $\eta = 5$ leads to $\theta = 0.013$ and $1 - \cos \theta < 10^{-4}$.
216The formula then reduces to
217\begin{equation}
218 t_2 = \frac{1}{c} \times (s-z)
219\end{equation}
220NB : for the moment, only neutrons and photons are assumed to be able to reach the ZDC. All other particles are neglected
221
222To fix the ideas, if the ZDC is located at $s=140~\textrm{m}$, neglecting $z$ and $\theta$, and assuming that $v=c$, one gets $t=0.47~\mu\textrm{s}$.
223
224\section{``High-level" objects reconstruction}
225
226\subsection{Jet reconstruction}
227
228Jets are reconstructed using a cone algorithm with $R=0.7$ and make only use of the smeared particle momenta. The reconstructed jets are required to have a transverse momentum above 20~GeV and $|\eta|<3.0$. A jet is tagged as $b$-jets if its direction lies in the acceptance of the tracker, $|\eta|<0.5$, and if it is associated to a parent $b$-quark. A $b$-tagging efficiency of $40\%$ is assumed if the jet has a parent $b$ quark. For $c$-jets and light/gluon jets, a fake $b$-tagging efficiency of $10 \%$ and $1 \%$ respectively is assumed.\\
229
230\subsection{$b$-tagging}
231
232The simulation of the $b$-tagging is based on the detector efficiencies assumed (1) for the tagging of a $b$-jet and (2) for the mis-identification of other jets as $b$-jets. This relies on the TAGGING\_B, MISTAGGING\_C and MISTAGGING\_L constants, for (respectively) the efficiency of tagging of a $b$-jet, the efficiency of mistagging a c-jet as a $b$-jet, and the efficiency of mistatting a light jet (u,d,s,g) as a $b$-jet. The (mis)tagging relies on the particle ID of the most energetic particle within a cone around the observed (eta,phi) region, with a radius CONERADIUS.
233
234\subsection{Tau identification}
235
236\begin{wrapfigure}{l}{0.3\columnwidth}
237\includegraphics[width=0.3\columnwidth]{Tau.eps}
238\caption{\small{detectorAng.eps}}
239\label{h_WW_ss_cut1}
240\end{wrapfigure}
241
242Jets originating from $\tau$-decay are identified using an identification procedure consistent with the one applied in a full detector simulation. The tagging rely on two tau properties. First, in roughly 75$\%$ of the time, the hadronic $\tau$-decay products contain only one charged hadron and a number of $\pi^0$. Second, the particles arisen from the $\tau$-lepton produce narrow jets in the calorimeter.
243
244\subsubsection*{Electromagnetic collimation}
245
246To use the narrowness of the $\tau$-jet, the \textit{electromagnetic collimation} ($C_{\tau}^{em}$) is defined as the sum of the energy in a cone with $\Delta R = ${\verb TAU_energy_scone } around the jet axis divided by the energy of the reconstructed jet. The energy in the small cone is calculated using the towers objects. To be taken into account a calorimeter tower should have a transverse energy above a given threshold {\verb JET_M_seed }. A large fraction of the jet energy, denominated here with {\verb TAU_energy_frac } is expected in this small cone. The quantity is represented in figure \ref{fig:tau1} for the default values (see table \ref{tab:tauRef}).
247
248\begin{figure}[!h]
249\begin{center}
250%\includegraphics[width=0.8\columnwidth]{figures/Taujets1.eps}
251\caption{\small{}}
252\label{fig:tau1}
253\end{center}
254\end{figure}
255
256\subsubsection*{$\tau$ selection using tracks}
257
258\begin{figure}[!h]
259\begin{center}
260%\includegraphics[width=0.8\columnwidth]{figures/Taujets2.eps}
261\caption{\small{}}
262\label{h_WW_ss_cut1}
263\end{center}
264\end{figure}
265
266The tracking isolation for the $\tau$ identification requires that the number of tracks associated to a particle with $p_T >$ {\verb TAU_track_pt } is one and only one in a cone with $\Delta R =$ {\verb TAU_track_scone }. This cone should be entirely included in the tracker to be taken into account. This procedure selects taus decaying hadronically with a typical efficiency of $60\%$. Moreover, the minimal $p_T$ of the $\tau$-jet is required to be {\verb TAUJET_pt }(default value: 10~GeV).\\
267
268\begin{table}[!h]
269\begin{center}
270\begin{tabular}[!h]{llc}
271\hline
272Tau definition & Card flag & Value\\\hline
273$\Delta R^{for~em}$ & {\verb TAU_energy_scone } & 0.15\\
274min $E_{T}^{tower}$ & {\verb JET_M_seed } & 1.0~GeV\\
275$C_{\tau}^{em}$ & {\verb TAU_energy_frac } & 0.95.\\
276$\Delta R^{for~tracks}$ & {\verb TAU_track_scone } & 0.4\\
277min $p_T^{tracks}$ & {\verb PTAU_track_pt } & 2 GeV\\\hline
278\end{tabular}
279\label{tab:tauRef}
280\end{center}
281\end{table}
282
283\subsection{Transverse missing energy}
284
285\section{Trigger emulation}
286
287\section{Validation}
288
289\section{Visualisation}
290
291
292As an illustration, an associated photoproduction of a $W$ boson and a $t$ quark is shown in Fig.~\ref{fig:wt}. This corresponds to a $pp \rightarrow Wt \ + \ p \ + \ X$ process, where the $Wt$ couple is induced by an incoming photon emitted by one interacting proton. This leading proton survives from the photon emission and subsequently from the $pp$ interaction, and is present in the final state. The experimental signature is a lack of hadronic activity in one forward hemisphere, where the surviving proton escapes. The $t$ quark decays into a $W$ and a $b$. Both $W$ bosons decay into leptons ($W \rightarrow \mu \nu_\mu$ and $W \rightarrow \tau \nu_\tau$).
293
294\begin{figure}[!h]
295\begin{center}
296\includegraphics[width=\columnwidth]{Events_Delphes_1}
297\caption{Example of $pp(\gamma p \rightarrow Wt)pY$ event. One $W$ boson decays into a $\mu \ \nu_\mu$ pair and the second one into a $\tau \ \nu_\tau$ pair. The surviving proton leaves a forward hemisphere with no hadronic activity. The isolated muon is shown as the blue vector. The $\tau$-jet is the cone around the green vector, while the reconstructed missing energy is shown in gray. One jet is visible in one forward region, along the beamline axis, opposite to the direction of the escaping proton.}
298\label{fig:wt}
299\end{center}
300\end{figure}
301
302
303\section{Conclusion and perspectives}
304
305
306\newpage
307
308\appendix
309
310\section{User manual}
311
312The available code is a tar file which comes with everything you need to run the \textsc{Delphes} package. Nevertheless in order to visualise the events with the \textsc{Frog} program, you need to install libraries as explained in {\it href="http://projects.hepforge.org/frog/}
313
314\subsection{Getting started}
315
316In order to run \textsc{Delphes} on your system, first download is sources and compile it:\\
317\begin{quote}
318\begin{verbatim}
319me@mylaptop:~$ wget http://www.fynu.ucl.ac.be/users/s.ovyn/files/Delphes_V_*.*.tar
320me@mylaptop:~$ tar -xvf Delphes_V_*.*. tar
321me@mylaptop:~$ cd Delphes_V_*.*
322me@mylaptop:~$ ./genMakefile.tcl >; Makefile
323me@mylaptop:~$ make
324\end{verbatim}
325\end{quote}
326
327
328\subsection{Running \textsc{Delphes} on your events}
329
330\subsubsection{Setting the run configuration}
331
332The program is driven by two datacards (default cards are data/DataCardDet.dat and data/trigger.dat) which allow a large spectrum of running conditions.
333{\b The run card }\\
334
335Contains all needed information to run \textsc{Delphes}
336\begin{itemize}
337
338\item The following parameters are available: detector parameters, including calorimeter and tracking coverage and resolution, transverse energy thresholds allowed for reconstructed objects, jet algorithm to use as well as jet parameters.
339
340\item Four flags, {\verb FLAG_bfield }, {\verb FLAG_vfd }, {\verb FLAG_trigger } and {\verb FLAG_frog } should be assigned to decide if the magnetic field propagation, the very forward detectors acceptance, the trigger selection and the preparation for \textsc{Frog} display respectively are running by \textsc{Delphes}.
341
342\item An example (the default detector card) can be found in {\verb files/DataCardDet.dat }
343\end{itemize}
344
345{\b The trigger card }\\
346Contains the definition of all trigger bits
347\begin{itemize}
348
349\item Cuts can be applied on the transverse momentum of electrons, muons, jets, tau-jets, photons and transverse missing energy.
350\item Be careful that the following structured should be used:
351 \begin{enumerate}
352 \item One trigger bit per line, the first entry in the line is the name of the trigger bit
353 \item If the trigger bit uses the presence of multiple identical objects, their transverse momentum thresholds must be defined in decreasing order
354 \item The different object requirements must be separated by a {\verb && } flag
355 \item Example of a trigger bit line:\\
356 \begin{quote}
357\begin{verbatim}
358DoubleElec >> ELEC1_PT: '20' && ELEC2_PT: '10'
359\end{verbatim}
360 \end{quote}
361 \end{enumerate}
362\item An example (the default trigger card) can be found <a href="files/trigger.dat" title="Home">here</a></li>
363\end{itemize}
364
365\subsubsection{Running the code}
366Create the above cards (data/mydetector.dat and data/mytrigger.dat)
367Create a text file containing the list of input files that will be used by \textsc{Delphes} (with extension *.lhe, *.root or *.hep)
368To run the code, type the following
369\begin{quote}
370\begin{verbatim}
371me@mylaptop:~$ ./Delphes inputlist.list OutputRootFileName.root data/mydetector.dat data/mytrigger.dat
372\end{verbatim}
373\end{quote}
374
375
376\subsection{Running an analysis on your \textsc{Delphes} events}
377
378Two examples of codes running on the output root file of \textsc{Delphes} are coming with the package
379\begin{enumerate}
380\item The {\verb Examples/Analysis_Ex.cpp } code shows how to access the available reconstructed objects and the trigger information The two following arguments are required: a text file containing the input \textsc{Delphes} root files to run, and the name of the output root file. To run the code:
381 \begin{quote}
382\begin{verbatim}
383./Analysis_Ex input_file.list output_file.root
384\end{verbatim}
385 \end{quote}
386
387\item The {\verb Examples/Trigger_Only.cpp } code permits to run the trigger selection separately from the general detector simulation on output \textsc{Delphes} root files. An input \textsc{Delphes} root file is mandatory as argument. The new tree containing the trigger information will be added in these file. The trigger datacard is also necessary. To run the code:
388 \begin{quote}
389\begin{verbatim}
390./Trigger_Only input_file.root data/trigger.dat
391\end{verbatim}
392 \end{quote}
393
394\end{enumerate}
395
396\subsection{Running the \textsc{Frog} event display}
397
398\begin{itemize}
399\item If the { \verb FLAG_frog } was switched on, two files were created during the run of \textsc{Delphes}: {\verb DelphesToFrog.vis } and {\verb DelphesToFrog.geom }. They contain all the needed information to run frog.
400\item To display the events and the geometry, you first need to compile \textsc{Frog}. Go to the {\verb Utilities/FROG } and type {\verb make }.
401\item Go back into the main directory and type {\verb ./Utilities/FROG/frog }.
402\end{itemize}
403
404\begin{thebibliography}{99}
405
406\bibitem{bib:Delphes} \textsc{Delphes}, hepforge:
407\bibitem{bib:FastJet} \textsc{Fast-Jet},
408\bibitem{bib:Frog} \textsc{Frog},
409\end{thebibliography}
410
411Attention : in SmearUtil::NumTracks, the function arguments 'Eta' and 'Phi' have been switched. Previously, 'Phi' was before 'Eta', now 'Eta' comes in front. This is for consistency with the other functions in SmearUtil. Check your routines, when using NumTracks !
412
413In the list of input files, all files should have the same type
414
415Attention : in SmearUtil::RESOLution::BJets, the maximal energy was looked in
416CONERADIUS/2 instead of CONERADIUS. This bug has been removed.
417
418Attention : for the tau-jet identification : CONERADIUS /2 was used instead of
419CONERADIUS !
420
421 in other words, the effect related to the particle showers that would happen in the calorimeters are not taken into account. We took the hypothesis that stable particles interacting electromagneticaly deposit their energies in the ECAL calorimeter and that the hadrons just interact with the HCAL
422
423\end{document}
Note: See TracBrowser for help on using the repository browser.