1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17 tutorial_aMCatNLO = """
18 You have entered tutorial mode. This will introduce you to the main
19 syntax options of MadGraph5_aMC@NLO for the computation of processes involving
20 NLO corrections.
21
22 To learn more about the different options for a command, you can use
23 MG_aMC>help A_CMD
24 To see a list of all commands, use
25 MG_aMC>help
26
27 The goal of this tutorial is to learn how to generate a process and to
28 produce an output for MadGraph5_aMC@NLO. In this part we will learn
29 a) How to generate a process involving NLO corrections
30 b) How to create the corresponding output for MadGraph5_aMC@NLO
31 c) How to run this output for computing NLO corrections
32
33 If you have FastJet (v3 or later) installed on your computer and you wish
34 to link it, please update the mg5_configuration file or type
35 MG5_aMC>set fastjet /path/to/fastjet-config
36 Otherwise the basic fastjet functionalities included in FJcore (shipped
37 with MadGraph5_aMC@NLO) will be used.
38
39
40 Let's start with the first point, how to generate a process at NLO:
41 MG5_aMC>generate p p > e+ ve [QCD]
42 Note that a space is mandatory between the particle names and that '[QCD]'
43 specifies that you want to consider QCD NLO corrections.
44 Couplings different than QCD cannot be perturbed yet.
45 """
46
47 tutorial = tutorial_aMCatNLO
48
49 generate = """
50 You have just generated a new process.
51 You can find more information on supported syntax by using:
52 MG_aMC>help generate
53 To list all defined processes, type
54 MG_aMC>display processes
55
56 If you want to know more about particles and multiparticles present,
57 write
58 MG_aMC>display particles
59 MG_aMC>display multiparticles
60
61 If you want to add a second process, use the add process command:
62 MG_aMC>add process p p > e+ e- [QCD] @2
63
64 At this stage you can export your processes.
65 This is done simply by typing:
66 MG_aMC>output MY_FIRST_AMCATNLO_RUN
67 """
68
69 display_processes = """
70 You have seen a list of the already defined processes.
71
72 At this stage you can export your processes to different formats. In
73 this tutorial, we will explain how to create a valid output for
74 MadGraph5_aMC@NLO. This is done simply by typing:
75 MG_aMC>output MY_FIRST_AMCTANLO_RUN
76 """
77
78 add_process = """
79 You have added a process to your process list.
80
81 At this stage you can export your processes.
82 This is done simply by typing:
83 MG_aMC>output MY_FIRST_AMCATNLO_RUN
84 """
85 output = """
86 If you are following the tutorial, a directory MY_FIRST_AMCATNLO_RUN has
87 been created which can be used in order to run simulation including NLO corrections.
88
89 Additionally to the commands in the bin directory (see
90 MY_FIRST_AMCATNLO_RUN/README), you can also generate your events/compute the
91 cross-section from this interface.
92 You will generate events to be showered a la MC@NLO, compute the theoretical
93 and PDF error on the fly (if asked for in the run_card.dat) and shower the
94 events with the parton_shower MonteCarlo specified in the run_card.dat,
95 generating a file in the StdHEP format.
96 Please note that, since shower-specific counterterms have to be included in the
97 calculation, the parton level sample you will obtain can only be showered
98 with the selected MonteCarlo.
99 Note also that, because of the way they have been generated, the parton-level
100 events in the .lhe file are UNPHYSICAL.
101 In order to obtain physical results, please use the .hep file
102
103 Please enter
104 MG_aMC> launch
105
106 If you just want to generate the parton level .lhe file, please enter
107 MG_aMC> launch -p
108
109 (you can interrupt the computation to continue the tutorial by pressing Ctrl-C)
110
111 At any time, you can access more commands/options for running the output by
112 switching to an interactive interface for a given output folder 'MyFolder'.
113 You can do so by typing:
114 MG_aMC> launch -i MyFolder
115
116 Please see MY_FIRST_AMCATNLO_RUN/README to know about the available commands.
117 To know the possible options/modes for each command, simply tiple
118 'MyFolder'> help COMMAND
119 from the interface bound to the 'MyFolder' output.
120
121 """
122
123 open_index = output
124
125 launch = """This step ends the tutorial of the basic commands of for running
126 processes including NLO corrections.
127 You can always use the help to see the options available for different
128 commands. For example, if you want to know how to launch on multicore/cluster
129 just type
130 MG_aMC>help launch
131
132 To learn more about MadLoop StandAlone checks and runs, you can now follow
133 its tutorial with:
134 MG_aMC>tutorial MadLoop
135
136 To simply close this tutorial, enter
137 MG_aMC>tutorial stop
138 If you want to exit MG5, enter
139 MG_aMC>exit
140 """
141