← Back to branch summary

~maddevelopers/mg5amcnlo/WWW5_caching

« back to all changes in this revision

Viewing changes to users/mardelcourt/PROC_407857/PROC_407857/README.gridpack

  • Committer: John Doe
  • Date: 2013-03-25 20:27:02 UTC
  • Revision ID: john.doe@gmail.com-20130325202702-5sk3t1r8h33ca4p4
first clean version

Show diffs side-by-side

added added

removed removed

Lines of Context:
users/mardelcourt/PROC_407857/PROC_407857/README.gridpack
 
1
MadGraph/MadEvent 5
 
2
By Fabio Maltoni, Tim Stelzer and the CP3 development team
 
3
 
 
4
http://madgraph.phys.ucl.ac.be/
 
5
http://madgraph.hep.uiuc.edu/
 
6
http://madgraph.roma2.infn.it/
 
7
 
 
8
Technical Details for Setting Up and Running Gridpacks:
 
9
(see http://cp3wks05.fynu.ucl.ac.be/twiki/bin/view/Library/GridDevelopment)
 
10
 
 
11
Using the option
 
12
   .true.  = gridpack
 
13
in the run_card.dat will generate a gridpack.tar.gz. Online, the
 
14
results page will have a link to this package.
 
15
 
 
16
The gridpackage is meant to be sent over to the cluster or grid
 
17
nodes. It's completely frozen, meaning that you cannot change any
 
18
parameters or run options, apart from the # of event and the rnd
 
19
number.
 
20
 
 
21
When you unpack it you get:
 
22
run.sh
 
23
madevent/
 
24
The first is a script which accepts two numbers (the number of events
 
25
and the rnd number).
 
26
 
 
27
There are two optional packages that can be added to the gridpack:
 
28
 
 
29
DECAY is a optional directory that contains a program that decays
 
30
final state particles, keeping track of spin correlations at much as
 
31
possible. It is of particular use for decays of top quarks.
 
32
 
 
33
REPLACE is also an optional directory for lepton replacement. This is
 
34
usefull for instance in the case where the generation time of the
 
35
diagrams is critical (like for example in the case of (z/gamma>e, mu,
 
36
tau)+4 jets including b's).
 
37
See below for more details
 
38
 
 
39
Basic Use of Gridpacks:
 
40
 
 
41
Before you use the gridpack locally or over the grid, you need to
 
42
compile the package on a machine compatible with your cluster:
 
43
cd madevent
 
44
./bin/compile
 
45
and after that it is ready to go. There is also an option to compile
 
46
madevent with dynamic libraries. Use
 
47
./bin/compile dynamic
 
48
to compile with dynamic libraries for the madgraph source files. This
 
49
will replace all makefiles with makefile_dynamic and compile using
 
50
these new makefiles. Using dynamic libraries is greatly encouraged,
 
51
because it can make the compiled gridpack significantly smaller.
 
52
 
 
53
After a succesful compilation you can run the
 
54
./bin/clean4grid
 
55
script to remove all source files and reduce the size of the
 
56
package. Now you can just repackage and send it to some cpu in india
 
57
or run locallly (after chmod +x run.sh)
 
58
./run.sh 10000 37
 
59
 
 
60
DECAY:
 
61
 
 
62
The DECAY directory contains a program to decay final state
 
63
particles. It has been designed to keep track of spin correlations as
 
64
much as possible and is particularly useful for the decay of (anti)
 
65
top quarks E.g. for the decay of top quarks up to 95% of the
 
66
correlations are preserved. 
 
67
Note that DECAY also needs the HELAS directory to compile.
 
68
The DECAY package can be found in the MadGraph 5 developer's kit that
 
69
can be downloaded from the MadGraph /MadEvent Downloads webpage or
 
70
from Launchpad. To add the package to the gridpack, simply untar the
 
71
gridpack to get the ./madevent/ directory and the ./run.sh
 
72
script. Move the DECAY and the HELAS directories from the MG 5 developer's kit to the
 
73
directory in which you untarred the gridpack, to get here the three
 
74
directories and the one script file:
 
75
./madevent/                 ./DECAY/         ./HELAS         ./run.sh
 
76
The DECAY package is compiled automatically when
 
77
./bin/compile
 
78
is executed from the ./madevent directory. As input to specify the
 
79
decays, files with the names
 
80
input_x.in
 
81
should be put in the ./DECAY directory. (Where x is a number between 1
 
82
and 20.) These files are read automatically, and one file should be
 
83
put for each decaying particle. (E.g. for ttbar events 2 files are
 
84
necessary: one for the decay of the top and one for the anti-top.) The
 
85
first three lines of these files should be
 
86
1
 
87
../events_in.lhe
 
88
../events.lhe
 
89
while the fourth line specifies the particle that needs decay, e.g. put
 
90
t
 
91
for the decay of a top quark. The fifth line is an integer that
 
92
specifies the decay mode. This depends on the particle that is going
 
93
to be decayed. For top quarks it is:
 
94
1 = ' t -> b  w+ '
 
95
2 = ' t -> b  ve e+'
 
96
3 = ' t -> b  vm mu+'
 
97
4 = ' t -> b  vt ta+'
 
98
5 = ' t -> b  vl l+    (e+mu)'
 
99
6 = ' t -> b  vl l+    (e+mu+ta)'
 
100
7 = ' t -> b  j   j    (ud+cs)'
 
101
8 = ' t -> b  anything (e+mu+ta+ud+cs)'
 
102
and similar for the anti-top.
 
103
Hence this file decays all top quarks (ignoring anti-tops!) in the
 
104
event file leptonically.
 
105
 
 
106
REPLACE
 
107
 
 
108
REPLACE is a package that lets the user replace particles in event
 
109
files. This is particulary useful to save precious time in the
 
110
generation of the diagrams. For example, the generation of Z+4jets, in
 
111
which the Z is decay leptonically, will take (at least) three times
 
112
longer when the three generations of leptons are specified in the
 
113
process. Because we know that, if we assume that all of them are
 
114
massless, the decay of Z bosons is unfavored to any specific lepton
 
115
flavor, we could as well have generated events with only muons and
 
116
then randomly replacing the muons in the event file by electrons or
 
117
tau's with 33% probability for each. This is exactly what the REPLACE
 
118
script has been designed to do. Note that for MadGraph 5, this is less
 
119
of a problem, and in general the full process should be run
 
120
(preferentially using sm-no_masses to get as few run directories as
 
121
possible).
 
122
 
 
123
To add this functionality to the gridpack you'll have to create a
 
124
directory 'REPLACE" after you have untarred a gridpack to get the
 
125
following:
 
126
./madevent/                 ./REPLACE/                 ./run.sh
 
127
The replace.pl script from the ./madevent/bin/ directory as well as
 
128
the replace_card1.dat from the ./madevent/Cards needs to be copied to
 
129
the REPLACE directory by typing:
 
130
cp  ./madevent/bin/replace.pl  ./madevent/Cards/replace_card1.dat  ./REPLACE/
 
131
(Note the in the latest version of replace, the '1' add the end of the
 
132
filename is necessary, and can be any number between 1 and 20, to have
 
133
the possibility of more than one replace.) In the replace_card1.dat
 
134
the particles that needs to be replaced and the particles in which it
 
135
needs to be replaced have to be specified by their corresponding PDG
 
136
codes. E.g. adding the lines:
 
137
11 : 11 13 15
 
138
-11 : -11 -13 -15
 
139
will replace all electrons from the event file by electrons (i.e. do
 
140
nothing), muons or taus with equal probabilities, and simultaneously
 
141
positrons with positrons, anti-muons and anti-taus. The replace card
 
142
that can be used in the example above in which only diagrams where the
 
143
Z decays in muons were generated and need to be replaced by electrons
 
144
and taus can be found here: replace_card1.dat