Monte Carlo Tools

MC generators

ThePEG

• ThePEG web page (or page on HepForge)
• Toolkit for High Energy Physics Event Generation.

Installation

• Depends on GSL - GNU Scientific Library
• Installing GSL straight forward (./configure --prefix=$HOME/local;make;make install)
• Installing ThePEG as well (./configure --prefix=$HOME/local --with-gsl=$HOME/local;make;make install)

• To generate doxygen documentation, run make html.

Herwig++

• Herwig++ web page (and manual)

Installation

• Version 2.2.1: ./configure --prefix=$HOME/local --with-gsl=$HOME/local/ --with-thepeg=$HOME/local --with-pdf=$HOME/local --with-clhep=$HOME/local --with-hepmc=$HOME/local; make; make install.
• It is not necessary to use the configure flag --with-root=/path/to/root for Root based analysis.

• To generate doxygen documentation, run make html.

Running

• First is needed to create rpo file: Herwig++ init -i /usr/local/share/Herwig++/defaults/HerwigDefaults.in.
• Then creation of run file is needed: Herwig++ read LHC.in.
• Then run the file: Herwig++ run LHC.run -N 100.

Input files

Analysis

• For creation analysis plot has to be compiled with --with-hepmc option,

  insert LHCGenerator:AnalysisHandlers 0 /Herwig/Analysis/Plot
  insert LHCGenerator:AnalysisHandlers 0 /Herwig/Analysis/HepMCFile

• User analysis:

  cd /Herwig/Analysis
  create MyAnalysis::First first analysis/First.so
  insert /Herwig/Generators/LHCGenerator:AnalysisHandlers 0 first
  cd /Herwig/Generators

Pythia 8

• Pythia web page
• installation: download, ./configure;make

Sherpa

• Sherpa web page

Links to other Monte Carlos

• Beam halo generátor

MC Tools

PDFs

LHAPDF

• LHAPDF web page
• Les Houches Accord PDF Interface - interface to modern PDF sets.
• install: ./configure --prefix=$HOME/local;make;make install

Event records

HepMC

• HepMC web page
• Object oriented event record written in C++ for High Energy Physics Monte Carlo Generators
• install: ./configure --prefix=$HOME/local/ --with-momentum=MEV --with-length=MM;make;make install

HepEvt

• Old event record format used e.g. in fortran Herwig.

HEP libraries

CLHEP

• CLHEP web page
• Pet of HEP-specific foundation and utility classes such as random generators, physics vectors, geometry and linear algebra.
• install: ./configure --prefix=$HOME/local;make;make install

MC validation

Rivet

• Rivet web page
• A toolkit for validation of Monte Carlo event generators (descedant of HZTool written in C++)

Instalation

• Installation: run bootstrap script
• If not on machine with mounted /afs/cern.ch, the Genser mirror has to be installed - script for install is probably in Agile trunk (agile-genser-bootstrap).

A brief tutorial

• CDF uderlying event analysis, run 10000 in Herwig++ with Herwig++ in params/herwig/HwSetup.in file and store the result in MinBias.aida file (description in attached file, RivetNotes.pdf - slides from CTEQ-MCnet school):

     rivetgun -g Herwig++ -P tevatron1800.params -p INFILE=params/herwig/HwSetup.in -a CDF_2001_S4751469 -n 10000 -H MinBias

• -P - specifies file with parameters
• -p INFILE - specifies file with generator setting
• -a specifies, which analysis should be used
• -n - number of events to be generated
• -H - name of output file (automaticly suffix .aida is added)

• HwSetup.in:

insert SimpleQCD:MatrixElements[0] MEQCD2to2
set /Herwig/Shower/ShowerHandler:MPI Yes
cd /Herwig/UnderlyingEvent
set MPIHandler:Algorithm 1
# Cutoff for secondary scatters
set KtCut:MinKT 3.4
#
# This should always be 2*MinKT!!
set UECuts:MHatMin 6.8
# Set the inverse hadron radius
set MPIHandler:InvRadius 1.5
read UECuts.in

• relevant piece of UECuts.in:

cd /Agile
# create the cuts object for hadron collisions
set AgileCuts:ScaleMin 1.0*GeV
set AgileCuts:X1Min 1.0e-5
set AgileCuts:X2Min 1.0e-5
set AgileCuts:MHatMin 30.*GeV
# cut on jet pt 
create ThePEG::SimpleKTCut JetKtCut SimpleKTCut.so
set JetKtCut:Matcher /Herwig/Matchers/StandardQCDParton
set JetKtCut:MinKT 20.*GeV

• Run aidaclean MinBias.aida > MinBiasClean.aida to remove strange things from the file (e.g. infinite error bas), which will couse errors when reading in JAS.
• Compare with data (CDF_2001_S4751469.aida) in JAS3.

AGILe

• AGILe web page
• AGILe is A Generator Interface Library, i.e. a uniform object oriented C++ interface for a variety of Monte Carlo event generators, written in a variety of languages.

HZTool

• HZTool web page
• HZTool is a library of routines which will allow you to reproduce an experimental result using the four-vector final state from Monte Carlo generators.

Jet agorithms

SISCone

• SISCone web page
• Seedless Infrared Safe Cone jet algorithm

KtJet

• KtJet web page
• C++ implementation of the K⊥ jet algorithm
• install: requires CLHEP, ./configure --prefix=$HOME/local;make;make install

KTCLUS

• KTCLUS web page
• Original fortran implementation of Kt jet algoritm by Mike Seymour

-- OldrichKepka - 16 Jul 2008
-- VojtechJuranek - 12 Aug 2008