Package madgraph :: Package interface :: Module tutorial_text_nlo
[hide private]
[frames] | no frames]

Source Code for Module madgraph.interface.tutorial_text_nlo

  1  ################################################################################ 
  2  # 
  3  # Copyright (c) 2009 The MadGraph5_aMC@NLO Development team and Contributors 
  4  # 
  5  # This file is a part of the MadGraph5_aMC@NLO project, an application which  
  6  # automatically generates Feynman diagrams and matrix elements for arbitrary 
  7  # high-energy processes in the Standard Model and beyond. 
  8  # 
  9  # It is subject to the MadGraph5_aMC@NLO license which should accompany this  
 10  # distribution. 
 11  # 
 12  # For more information, visit madgraph.phys.ucl.ac.be and amcatnlo.web.cern.ch 
 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