[Rivet-svn] r3833 - schools/2010-Lauterbad/handouts/day3

[blackhole at projects.hepforge.org]

Author: hoeth
Date: Tue Jul 17 14:39:56 2012
New Revision: 3833

Log:
Lauterbad day3 handout

Added:
   schools/2010-Lauterbad/handouts/day3/day3.tex

Added: schools/2010-Lauterbad/handouts/day3/day3.tex
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ schools/2010-Lauterbad/handouts/day3/day3.tex	Tue Jul 17 14:39:56 2012	(r3833)
@@ -0,0 +1,125 @@
+\documentclass[a4paper,10pt]{scrartcl}
+
+\usepackage{fullpage}
+\usepackage{amsmath}
+\usepackage{helvet}
+\usepackage{url}
+
+\setlength{\parindent}{0in}
+\newcommand{\done}{{\rm d}}
+\newcommand{\nnb}{\nonumber}
+
+
+%opening
+\title{CTEQ-MCnet School 2010 Tutorials: \\ Day 3 Rivet -- Minimum Bias}
+\date{}
+
+\begin{document}
+
+\maketitle
+
+\section{Introduction}
+
+Today you will write a simple Rivet analysis from scratch. ATLAS has
+published minimum bias data at 900\,GeV, and we want to compare the data
+with Monte Carlo. You find the publication in the
+{\tt day3/shared/publications} directory. In the same directory you also
+find a CDF minimum bias analysis which we provide as guidance.
+
+\section{Writing the Rivet analysis}
+
+Rivet has a plug-in system for analyses, so that one can write a private
+analysis without touching the rest of the Rivet installation. The
+analysis is compiled into a shared library which Rivet loads during
+runtime. In order to tell Rivet where to find this plug-in analysis, you
+need to set some paths before you start:
+
+\begin{verbatim}
+  . /home/mcnet/day3/shared/setup.sh
+\end{verbatim}
+
+Now go to the {\tt day3/shared/rivet} directory, where you find a couple
+of files:
+
+\bigskip
+\begin{tabular}{l@{~~--~~}l}
+{\tt CDF\_2009\_S8233977.cc}   & Source code of the CDF analysis, provided as guidance. \\
+{\tt ATLAS\_900\_MINBIAS.cc}   & Source code skeleton for the ATLAS analysis. Edit this! \\
+{\tt ATLAS\_900\_MINBIAS.info} & Some meta data. Used by {\tt rivet --show-analysis}.\\
+{\tt ATLAS\_900\_MINBIAS.aida} & The experimental data. Used by {\tt rivet-mkhtml} for the comparison plots. \\
+{\tt ATLAS\_900\_MINBIAS.plot} & Plotting defaults for the comparison plots. \\
+{\tt Makefile}                 & The makefile for the ATLAS plug-in analysis.
+\end{tabular}
+\medskip
+
+You will be editing the {\tt ATLAS\_900\_MINBIAS.cc} source file. To
+compile it, simply run {\tt make}.
+
+Rivet documentation can be found on the Rivet homepage {\tt
+http://projects.hepforge.org/rivet/code/dev/}. You can also look at the
+header files in {\tt /opt/include/Rivet} and {\tt /opt/include/LWH}. The
+most important methods are listed on the other handout you got, too.
+
+\section{Running the generator and Rivet}
+
+Like yesterday, Herwig and Sherpa are calling Rivet through the API,
+while Pythia uses a pipe to pass the HepMC events to Rivet. We have
+prepared run cards for all three generators, which you find in the
+{\tt day3} directory. Enter the directory for the generator you like to
+use and source the {\tt /home/mcnet/day3/shared/setup.sh} file before
+you run the generator. Otherwise Rivet will not be able to find your
+analysis! Then you can use the commands listed below to produce
+{\tt .aida} histogram files which you can plot with {\tt rivet-mkhtml}.
+Once your analysis is working, feel free to change the generator
+settings and play around (what happens for example if you switch off the
+underlying event?).
+
+\subsection{Herwig}
+
+For the ATLAS analysis:
+
+\begin{verbatim}
+  Herwig++ read Minbias-900.in
+  Herwig++ run  Minbias-900.run -N 10000
+\end{verbatim}
+
+For the CDF analysis:
+
+\begin{verbatim}
+  Herwig++ read Minbias-1960.in
+  Herwig++ run  Minbias-1960.run -N 10000
+\end{verbatim}
+
+\subsection{Pythia}
+
+For the ATLAS analysis:
+
+\begin{verbatim}
+  mkfifo pipe900.hepmc
+  main32.exe minbias900.cmnd pipe900.hepmc &
+  rivet -a ATLAS_900_MINBIAS -H Pythia900.aida pipe900.hepmc
+\end{verbatim}
+
+For the CDF analysis:
+
+\begin{verbatim}
+  mkfifo pipe1960.hepmc
+  main32.exe minbias1960.cmnd pipe1960.hepmc &
+  rivet -a CDF_2009_S8233977 -H Pythia1960.aida pipe1960.hepmc
+\end{verbatim}
+
+\subsection{Sherpa}
+
+For the ATLAS analysis:
+
+\begin{verbatim}
+  Sherpa RUNDATA=Run.900.dat
+\end{verbatim}
+
+For the CDF analysis:
+
+\begin{verbatim}
+  Sherpa RUNDATA=Run.1960.dat
+\end{verbatim}
+
+\end{document}