Vous êtes sur la page 1sur 94

Practical introduction

into selected TOOLS


for High Energy Physics

Alexander Belyaev

Southampton University & Rutherford Appleton LAB

NExT PhD School


2017

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 1
To test theory we need
theory data link
which is actually a non-trivial story

THEORY DATA

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 2
theory data requires observables
to be compared with data

THEORY OBSERVABLES

DATA

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 3
theory data requires observables
to be compared with data
and we need TOOLS to do this!

THEORY OBSERVABLES

TOOLS!

DATA

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 4
Tools for theory observables link

DM Feynman
Model Rules

LanHEP
FeynRules
SARAH

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 5
Tools for theory observables link

DM Feynman Matrix
Model Rules Element

CalcHEP, CompHEP
LanHEP FormCalc,MadGraph,
FeynRules MCFM, MC@NLO,
SARAH Sherpa, WHizard

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 6
Tools for theory observables link

DM Feynman Matrix
Events
Model Rules Element

CalcHEP, CompHEP
LanHEP PYTHIA
FormCalc,MadGraph,
FeynRules HERWIG
MCFM, MC@NLO, ISAJET
SARAH Sherpa, WHizard Sherpa

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 7
Tools for theory observables link

DM Feynman Matrix
Events Detector
Model Rules Element

FAST/FULL
CalcHEP, CompHEP Detector
LanHEP PYTHIA
FormCalc,MadGraph, Simulation
FeynRules HERWIG
MCFM, MC@NLO, ISAJET
SARAH Sherpa, WHizard PGS, Delphes
Sherpa
/
CMSSW,
ATHENA

Collider signatures

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 8
Tools for theory observables link

DM Feynman Matrix
Events Detector
Model Rules Element

FAST/FULL
CalcHEP, CompHEP Detector
LanHEP PYTHIA
FormCalc,MadGraph, Simulation
FeynRules HERWIG
MCFM, MC@NLO, ISAJET
SARAH Sherpa, WHizard PGS, Delphes
Sherpa
/
CMSSW,
ATHENA
P

M
HE

ad
Relic Density
lc

gr
Collider signatures
Ca

a
ph
DM Direct Detection
micrOMEGAs MadDM

DM Indirect Detection

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 9
Tools for theory observables link

DM Feynman Matrix
Events Detector
Model Rules Element

FAST/FULL
CalcHEP, CompHEP Detector
LanHEP PYTHIA
FormCalc,MadGraph, Simulation
FeynRules HERWIG
MCFM, MC@NLO, ISAJET
SARAH Sherpa, WHizard PGS, Delphes
Sherpa
/
CMSSW,
ATHENA
P

M
HE

ad
Relic Density
lc

gr
Collider signatures
Ca

a
ph
DM Direct Detection
micrOMEGAs MadDM

DM Indirect Detection

Analysis to find/exclude/modify theory:


Plots, PAW/Root, Fortran/C++ codes, Private codes,
MasterCode, CHECKMATE, MadAnalysis, HEPMDB
Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 10
Tools for theory observables link

DM Feynman Matrix
Events Detector
Model Rules Element

FAST/FULL
CalcHEP, CompHEP Detector
LanHEP PYTHIA
FormCalc,MadGraph, Simulation
FeynRules HERWIG
MCFM, MC@NLO, ISAJET
SARAH Sherpa, WHizard PGS, Delphes
Sherpa
/
CMSSW,
ATHENA
P

M
HE

ad
Relic Density
lc

gr
Collider signatures
Ca

a
ph
DM Direct Detection
micrOMEGAs MadDM

DM Indirect Detection

Analysis to find/exclude/modify theory:


Plots, PAW/Root, Fortran/C++ codes, Private codes,
MasterCode, CHECKMATE, MadAnalysis, HEPMDB
Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 11
TOOLS repositories
ARepositoryForBeyond-the-Standard-ModelTools
https://www.hepforge.org/projects

MC4BSMworkshop
http://theory.fnal.gov/mc4bsm/

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 12
Outline of the course
Lecture I: MatrixElementCalculations:CalcHEP

Lecture II: ModelImplementation:LanHEP


andmodelrepository:
HighEnergyPhysicsModelDatabase(HEPMDB)

Lecture III: BeyondthePartonLevel:PYTHIAandanalysis


framework:CHECKMATE

Lecture IV: DarkMatter:micrOMEGASand


advancedtopicsonCalcHEP

Lecture V: Advancedtopics

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 13
Youmust
Do not hesitate to ask questions during the lecture

There are exercises(ex#)for you, to do this week, i.e.


duringthiscourse

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 14
Lecture I:
Introduction into CalcHEP
systemrequirements&linuxprimer
installation
modelsandsymbolicsession
numericalsessionandkinematicaldistributions
eventgeneration
CalcHEPBatchInterface

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 15
Web page & contacts
TheWEBpageofCalcHEP
http://theory.npi.msu.su/~pukhov/calchep.html
arXiv:1207.6082

e-mails
calchep@googlegroups.com
a.belyaev@soton.ac.uk

"HEPTOOLSdropboxdirectory"availableat
http://www.personal.soton.ac.uk/ab1u06/webpage/hep_tools.html

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 16
Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 17
Prerequisites
basicknowledgeofLinux/UNIX
SeeLinuxprimerinthedropbox(thankstoElenaVataga)

gcccompiler
gfortrancompiler
Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 18
CalcHEP
was born as a CompHEP in 1989: MGU-89-63/140
Author(s)
Alexander Pukhov, AB, Neil Christensen
(AB and Neil Christensen have joined the project in 2009)
http://theory.npi.msu.su/~pukhov/calchep.html
Idea
The effective study of HEP phenomenology passing at high
level of automation from your favorite model to physical
observables such as decay width, branching ratios, cross
sections kinematic distributions, parton-level events, ...
Analogous packages (matrix element generators)
http://www.ippp.dur.ac.uk/montecarlo/BSM/

CompHEP (Boos et al)


MadGraph/MadEvent (Maltoni, Stelzer)
Grace/Helas (Fujimoto et al)
FeynArts/FeynCalc/FormCalc (Hahn et al)
WHIZARD,O'mega (Moretti, Ohl, Reuter)
Sherpa (Krauss et al)
Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 19
Features/Limitations of CalcHEP
Can evaluate any decay and scattering processes
within any (user defined) model!

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 20
Features/Limitations of CalcHEP
Can evaluate any decay and scattering processes
within any (user defined) model!
Tree-level processes

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 21
Features/Limitations of CalcHEP
Can evaluate any decay and scattering processes
within any (user defined) model!
Tree-level processes
Squared Matrix Element calculation
no spin information for outgoing particles spin averaged
amplitude

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 22
Features/Limitations of CalcHEP
Can evaluate any decay and scattering processes
within any (user defined) model!
Tree-level processes
Squared Matrix Element calculation
no spin information for outgoing particles spin averaged
amplitude
Limit on number of external legs (involved particles) and
number of diagrams
official limit 8 , unofficial none
limit is set from the practical point of view:
2 6 (17) set the essential time/memory limit

number of diagrams ~ 500 set the disk space and


the time limit
Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 23
http://theory.npi.msu.su/~pukhov/calchep.html

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 24
http://theory.npi.msu.su/~pukhov/calchep.html

manual

new options and


writeup!
arXiv:1207.6082

Connected to
launchpad system
Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 25
Quick start with CalcHEP:
practical notes on the installation
Downloadcode,readmanualandcompile
http://theory.npi.msu.su/~pukhov/calchep.html
tar -zxvf calchep_3.x.x.tgz
cd calchep_3.x.x
make
the current version is 3.x.x = 3.6.28
Create work directory
From calchep_3.x.x directory (e.g. ../calc_work)
./mkWORKdir ../calc_work
Supported operating system
Linux, IRIX, IRIX64, HP-UX, OSF1, SunOS, Darwin, CYGWIN
(see getFlags file)

Exercise#1: Install CalcHEP

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 26
Compilation, potential problem and its
solution
To compile the CalcHEP source code you need:
C compiler, the X11 graphics library and the X11 include files
"CalcHEP is compiled successfully and can be started "
is a good sign

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 27
Compilation, potential problem and its
solution
To compile the CalcHEP source code you need:
C compiler, the X11 graphics library and the X11 include files
"CalcHEP is compiled successfully and can be started "
is a good sign

Compilation for High Precision Calculations


Intel C compiler has a _Quad type, -D QUAD has to be added to FlagsForSh as
CFLAGS="-D_QUAD_ -fPIC -fsigned-char -Qoption,cpp,--extended_float_type

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 28
Compilation, potential problem and its
solution
To compile the CalcHEP source code you need:
C compiler, the X11 graphics library and the X11 include files
"CalcHEP is compiled successfully and can be started "
is a good sign

Compilation for High Precision Calculations


Intel C compiler has a _Quad type, -D QUAD has to be added to FlagsForSh as
CFLAGS="-D_QUAD_ -fPIC -fsigned-char -Qoption,cpp,--extended_float_type
Potential problem in compilation
The most frequent compilation problem is due to the absence of the X11 include
files; CalcHEP still compiles, however, it only runs in non-interactive mode
./calchep will give
Error: You have launched the interactive session for a version
of CalcHEP that has been compiled without the X11 library.
Presumably, the X11 development package is not installed on
your computer.
the following additional package should be install to run CalcHEP in GUI mode
libX11-devel for Fedora/Scientific, Darwin(MAC)
libX11-dev for Ubuntu/Debian
xorg-x11-devel for SUSE
Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 29
Starting CalcHEP
cd ../calc_work
Files:
bin -> ........ /calchep_3.x.x/bin
calchep
calchep_batch
calchep.ini
models/
results/
tmp/

Start:
./calchep

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 30
Starting CalcHEP

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 31
Principle KEYS for CalcHEPs GUI

Exit menu Help!


Enter menu
selection
selection
(back)
(forward)

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 32
Starting CalcHEP

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 33
CalcHEP menu structure: symbolic part

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 34
CalcHEP menu structure: symbolic part

Choiceofthegauge

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 35
Initial Menu after the model choice
ChooseyourgaugeEnterProcess
EditModel NumericalEvaluation

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 36
The Model Structure
Parameters Constraints
Particles Vertices

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 37
Particles: prtclxx.mdl (spins 0,1/2,1,3/2,2)

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 38
Particles: prtclxx.mdl

Higgsbosonwidthwillbecalculated`onthefly`

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 39
Independent parameters: varsxx.mdl

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 40
Dependent parameters(constraints): funcxx.mdl

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 41
Feynman rules: lgrngxx.mdl

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 42
External Libraries: extlibxx.mdl
Typically is empty for simple models but can be used for any library which helps to build
complicated model. E.g. mass spectra calculator for SUSY (involving RGE solutions etc)

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 43
Numerical evaluation of masses & branchings

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 44
Numerical evaluation of masses & branchings

Exercise#2: Find the SM particles


spectrum and Br ratios

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 45
Details of symbolic session
the input syntax: P1[,P2] -> P3,P4 [,,...,[N*x]]

hadron/composite particle scattering


'p,p->W+,b,B'
unknown particle are assumed to be composite:
'p' consists of u,U,d,D,s,S,c,C,b,B,G

wild cards/names for outgoing particles


'H -> 2*x'

intermediate particles can be non-trivially excluded


'W+ > 2, A>1, Z>3' Exercise#3: Evaluate SM Higgs total
widths and Br ratios as a function of
its mass in the 100-500 GeV range

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 46
Symbolic session (1)

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 47
Symbolic session (2)

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 48
Symbolic session (3)

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 49
Symbolic session (4)

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 50
Symbolic session (5)

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 51
Symbolic session (6)

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 52
Symbolic session (7)

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 53
Symbolic session (8)

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 54
Symbolic session (9)

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 55
Numerical part of CalcHEP

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 56
Menu structure of the numerical part

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 57
subprocess menu

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 58
control of the initial states and parton density
functions

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 59
model parameters

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 60
dependent parameters (SM CKM=1 with hGG/AA)

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 61
QCD coupling and the scale

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 62
control of resonances

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 63
control of resonances

F1

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 64
Aliases

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 65
setting kinematical cuts

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 66
setting kinematical cuts

F1

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 67
MC inegration and event generation is based on
John von Neumann selection-rejection procedure
sample u1=rnd1, u2=rnd2
x= xmin +(xmin-xmax) u1
f*= fmax * u2
check whether or not f(x) > f*
If this holds, accept x as a realization of f(x)
if not, reject the value of x and repeat the sampling step
as a results, the x will be generated according to a f(x),
Naccepted/Ntotal* (x_min-xmax)* fmax = area under the curve

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 68
MC inegration and event generation is based on John von
Neumann acceptance-rejection procedure
The efficiency of the method strongly depends on the behavior
of the function. Eventually it is equal to the ratio of the useful
and total volume. And it can be very low in case of sharp
resonances!

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 69
phase-space mapping

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 70
integration over the phase space

The accuracy and the


stability of the cross
section indicate that you
can trust your results

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 71
Resulting Mbb and MWtb kinematical distributions

Exercise#4
1. Calculate WbB production rates at the LHC
for PT b-jet > 20 GeV, b-Jet separation > 0.5,
max pseudorapidity < 3
2. Plot bb- and Wb invariant mass distributions
for PT b-jet > 20 GeV and PT b-jet > 40 GeV

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 72
events generations

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 73
File with events in the native CalcHEP format

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 74
GUI gives user a full control of details
of symbolic/numerical session.
To sum over the sub-processes one should use scripts

thereareseveralscriptswhichrunvariousloopstofacilitatecalculation

cycleoversubprocesses
exitfromthenumericalsession
cd results

../bin/subproc_cycle luminmax

requires2parameters:
1.luminosity
2.maxnumberofeventsperprocess
e.g.
../bin/subproc_cycle 1000 100000
You should run it from results dir where the n_calchep binary is!

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 75
running subproc_cycle for SM model

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 76
running subproc_cycle for SM CKM=1 model

bunch of events_nn.txt eventfilesarecreated,


sohowdowecombinethem?

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 77
We need Events in LHE format to talk to MC generators!
bin/event_mixerLuminosity[1/fb]neventsevent_dirs
mixes subprocesses and connects production and decay events

theoutputisevent_mixer.lhe file

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 78
Accessing all your results

results are stored in results directory


output files:
n_calchep numerical module
prt_nn protocol
distr_nn_mm summed distributions
distr_nn individual distribution
events_nn.txt events file
list_prc.txt list of processes
qnumbers qnumbers PYTHIA input with new prt
definitions
session.dat current session status format is similar to
prt_nn one
for every new process the results directory is offered to be renamed
or removed

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 79
protocol prt_nn

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 80
useful scripts for numerical session

see calchep_x.x.x/bin/ directory and README file!

subproc_cycle ../bin/subproc_cycle 1000 100000


sum_distr ../bin/sum_distr distr_2 distr_3 > distr_sum
show_distr ../bin/show_distr distr_sum
plot_view ../bin/plot_view < tab_1.txt
events2tab
lhe2tab
Exercise#5
gen_events produce LHE file
and use lhe2tab
name_cycle to produce
distributions
pcm_cycle
par_scan

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 81
scripts for numerical session
events2tab
Parameters:
1- name of variable,
2- minimum limit,
3- maximum limit,
4- number of bins(<=300).
File with events must be passed to input.
../bin/events2tab T(b) 1 100 200 < events_1.txt >tab.txt
../bin/tab_view < tab.txt

name_cycle
1: Name of parameter
2: Initial value
3: Step
4: Number of steps

../bin/name_cycle Mh 100 10 11

scripts above became a part of calchep_batch interface will be


discussed below

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 82
the most general scan with
par_scan
Usage:
$CALCHEP/bin/par_scan < data_file

Data file structure:

where par_name_i present free parameters of the models. Among them


one also can write momenta of incoming particles as momentum1 and
momentum2.
fun_name_i is the name of constrained parameter which will be
presented in output file
Output file has the same structure as input plus calculated numerical
values for constrained parameters, and an additional column for
evaluated cross section with statistical error
If you are not interested in the prt_# files you can clean it using
$CALCHEP/bin/par_scan clean < data_file

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 83
CalcHEP batch interface

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 84
CalcHEP batch interface: all results in one shot

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 85
CalcHEP batch interface: running and monitoring

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 86
CalcHEP batch interface:
monitoring the progress

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 87
CalcHEP batch interface:
monitoring details of the symbolic section

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 88
CalcHEP batch interface:
monitoring results of the numerical session

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 89
CalcHEP batch interface:
details of the numerical session

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 90
CalcHEP batch interface:
numerical results and distributions

gnuplot should be
installed to make the
plots with the batch
interface!

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 91
CalcHEP batch interface:
access to your results

results are located in batch_results folder

*.lhe.gz : LHE event files

*.jpg : figures

*.distr : files with distributions which cab be used


to re-produce plots using $CALCHEP/bin/show_distr

*.tgz : zipped html folder with all numerical details, .txt


and .html files of the batch run

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 92
CalcHEP batch interface:
some additional features/tricks
see https://answers.launchpad.net/calchep
for many tricky questions/answers
scanning over the collider energy
Run parameter: rtS
Run begin: 7
Run step size: 1
Run n steps: 2

p1: 1000*rtS/2
p2: 1000*rtS/2
rtS here is some fake parameter
you can use fake parameter only if you define it as a loop
parameter
It can be used in the cut statement (assigning cut to the symbol)
It can be assigned to the parameter model this way you can run
use complicated scan

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 93
CalcHEP interface to MC generators via
Events in the LHE format

CalcHEP interface with MC


generators: LHEF output

CalcHEP
Production event mixer PYTHIA/
and LHEF
decay events HERWIG
QNUMBERS

Decay of new particles with


CalcHEP, QNUMBERS are
THEORY automatically created and EXP DATA
written to LHEF

Alexander Belyaev Practical introduction into selected TOOLS for High Energy Physics 94

Vous aimerez peut-être aussi