1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16 tutorial = """
17 You have entered tutorial mode. This will introduce you to the main
18 syntax options of MadGraph5_aMC@NLO.
19
20 To learn more about the different options for a command, you can use
21 MG5_aMC>help A_CMD
22 To see a list of all commands, use
23 MG5_aMC>help
24
25 The goal of this tutorial is to learn how to generate a process and to
26 produce the output for MadEvent. In this part we will learn
27 a) How to generate a process
28 b) How to create output for MadEvent
29 c) How to run the MadEvent output
30
31 Let's start with the first point, how to generate a process:
32 MG5_aMC>generate p p > t t~
33 Note that a space is mandatory between the particle names.
34 """
35
36 generate = """
37 You have just generated a new process.
38 Note that the coupling order \"QED=0\" was automatically added by MG5
39 to avoid non-QCD diagrams which have negligible contribution.
40 You can find more information on supported syntax by using:
41 MG5_aMC>help generate
42 To list all defined processes, type
43 MG5_aMC>display processes
44
45 If you want to know more about particles and multiparticles present,
46 write
47 MG5_aMC>display particles
48 MG5_aMC>display multiparticles
49
50 If you want to add a second process, use the add process command:
51 MG5_aMC>add process p p > W+ j, W+ > l+ vl @2
52 This adds a decay chain process, with the W+ decaying
53 leptonically.
54
55 At this stage you can export your processes to different formats. In
56 this tutorial, we will explain how to create output for MadEvent.
57 This is done simply by typing:
58 MG5_aMC>output MY_FIRST_MG5_RUN
59 """
60
61 display_processes = """
62 You have seen a list of the already defined processes.
63
64 At this stage you can export your processes to different formats. In
65 this tutorial, we will explain how to create a valid output for
66 MadEvent. This is done simply by typing:
67 MG5_aMC>output MY_FIRST_MG5_RUN
68 """
69
70 add_process = """
71 You have added a process to your process list.
72
73 At this stage you can export your processes to different formats. In
74 this tutorial, we will explain how to create output for MadEvent.
75 This is done simply by typing:
76 MG5_aMC>output MY_FIRST_MG5_RUN
77 """
78 output = """
79 If you are following the tutorial, a directory MY_FIRST_MG5_RUN has
80 been created which can be used in order to run MadEvent exactly as if
81 it was coming from MG4.
82
83 Additionally to the MG4 command (see MY_FIRST_MG5_RUN/README), you can also
84 generate your events/compute the cross-section from this interface:
85 Please Enter:
86 MG5_aMC> launch MY_FIRST_MG5_RUN
87 (you can interrupt the computation to continue the tutorial by pressing Ctrl-C)
88 """
89
90 open_index = output
91
92 launch = """This step ends the tutorial of the basic commands of MG5_aMC. You can
93 always use the help to see the options available for different
94 commands. For example, if you want to know all valid output formats,
95 you can enter
96 MG5_aMC>help output
97
98 In order to close this tutorial please enter
99 MG5_aMC>tutorial stop
100 If you want to exit MG5_aMC please enter
101 MG5_aMC>exit
102
103 But you can also continue the tutorial to learn some other useful
104 commands:
105 d) How to load a model
106 e) How to define a multi-particle label
107 f) How to store a history of the commands in a session
108 g) How to call shell commands from MG5_aMC
109 h) How to draw the diagrams for your processes without generating
110 MadEvent output
111
112 To import a model, write:
113 MG5_aMC>import model mssm
114 """
115
116 import_model ="""
117 You have successfully imported a model. If you followed the tutorial
118 this is the MSSM.
119
120 If you want to know more information about this model you can use the
121 following commands:
122 MG5_aMC>display particles
123 MG5_aMC>display interactions
124 MG5_aMC>display multiparticles
125 which show information on the particles and the vertices of the model
126 or presently defined multiparticle labels.
127
128 Some of the model (including mssm) allow to modify the model (setting some
129 mass to zero, put some matrices diagonal, remove some interaction, ...). You can
130 see the possibility for each model by using the following command:
131 MG5_aMC> customize_model
132
133 To define a multiparticle label, i.e. a label corresponding to a set
134 of particles, write:
135 MG5_aMC>define v = w+ w- z a
136 This defines the symbol \"v\" to correspond to any EW vector boson.
137 """
138 import_model_v4 = import_model
139
140
141 customize_model ="""
142 The model with your customization is now loaded and you can use it as any other
143 model. Note that if you want to save this specific customization you can do the
144 following:
145 MG5_aMC> customize_model --save=NAME
146 the model will then be accessible by the command (assuming that you are based on mssm)
147 MG5_aMC> import model mssm-NAME
148
149 To define a multiparticle label, i.e. a label corresponding to a set
150 of particles, write:
151 MG5_aMC>define v = w+ w- z a
152 This defines the symbol \"v\" to correspond to any EW vector boson.
153 """
154
155
156 define = """
157 You have just defined a multiparticle label.
158 If you followed the tutorial, the label is \"v\"
159
160 Note that some multiparticles such as as p, j, l+, l- are
161 predefined. Type
162 MG5_aMC>display multiparticles
163 to see their definitions.
164
165 MG5 allows you to store a file with the list of command that you have
166 used in an interactive session:
167 MG5_aMC>history my_mg5_cmd.dat
168 """
169
170 history = """
171 You have written a history file. If you followed the tutorial this
172 should be ./my_mg5_cmd.dat. In order to load a history file and
173 execute the commands in it, you can do:
174 MG5_aMC>import command my_mg5_cmd.dat
175 or from the shell:
176 ./bin/mg5_aMC my_mg5_cmd.dat
177
178 It is also possible to display this file directly from MG5_aMC:
179 MG5_aMC>open ./my_mg5_cmd.dat
180 """
181
182
183 open_index = output
184
185 open = """
186 Note that in order to open some file, you might be need to use a shell command.
187 Any shell command can be launched by MG5_aMC, by running \"shell\" or
188 starting the line by an exclamation mark (!).
189
190 The final command of the tutorial is display diagrams. This allows you to draw and
191 look at the diagrams for your processes (in eps format) before
192 creating an output for a given format. This can be useful for a fast
193 check of your process. For this last command, we will also show how combine
194 different command in a single line:
195 MG5_aMC>generate p p > go go; display diagrams
196
197 Note that when you run output [madevent_v4], the diagrams are
198 automatically written to the matrix.ps files in subprocess
199 directory, just like with MadGraph 4.
200 """
201
202 display_diagrams = """
203 This command was the last step of the tutorial.
204 Quit the tutorial by typing:
205 MG5_aMC>tutorial stop
206
207 Thanks for using MadGraph5_aMC@NLO.
208 """
209