| 1 | |
| 2 | |
| 3 | == How can I implement a new physics model in Software.MadGraph / Software.MadEvent ? == |
| 4 | |
| 5 | === The "old" way : using {{{USRMOD}}} v1 === |
| 6 | This is "traditional" way to create a new physics model in Software.MadGraph / Software.MadEvent v4. You should use the {{{USRMOD}}} template directory present in the {{{Models}}} directory. The full procedure to follow is extensively described [http://cp3wks05.fynu.ucl.ac.be/Manual/usrmod.html here]. |
| 7 | |
| 8 | This method has been successfully used over the past to create several new Physics models. However, it presents two important disadvantages: |
| 9 | * The base model is always the SM and the possible modifications are restricted (e.g. removing a particle is not possible). This was due to the important structural differences in the original BSM models provided with Software.MadGraph / Software.MadEvent v4. |
| 10 | * Feynman rules should be computed by hand. |
| 11 | To address these issues, two new methods are now available and should be preferentially used (starting from the future version 4.6, old models files, including those produced with the {{{USRMOD}}} v1, will only be passively supported). |
| 12 | |
| 13 | === The "new" way : using [http://feynrules.phys.ucl.ac.be FeynRules] and/or {{{USRMOD}}} v2 === |
| 14 | |
| 15 | ==== [http://feynrules.phys.ucl.ac.be FeynRules] ==== |
| 16 | According to the [http://feynrules.phys.ucl.ac.be FeynRules] website, "[http://feynrules.phys.ucl.ac.be FeynRules] is a Mathematica® package that allows the calculation of Feynman rules in momentum space for any QFT physics model. The user needs to provide FeynRules with the minimal information required to describe the new model, contained in the so-called model-file. This information is then used to calculate the set of Feynman rules associated with the Lagrangian. The Feynman rules calculated by the code can then be used to implement the new physics model into other existing tools, such as MC generators. This is done via a set of interfaces which are developed together and maintained by the corresponding MC authors." |
| 17 | |
| 18 | All interested users should report directly to the [http://feynrules.phys.ucl.ac.be FeynRules] website for more information on this convenient tool and on the associated [http://feynrules.phys.ucl.ac.be/view/Main/MadGraphInterface interface] for Software.MadGraph / Software.MadEvent. |
| 19 | |
| 20 | Thanks to its high capabilities, including a user friendly interface, the automatized model generation for arbitrary QFT physics theories and robust validation procedures, [http://feynrules.phys.ucl.ac.be FeynRules] and the corresponding interface will be the default tool to generate important Software.MadGraph / Software.MadEvent models starting from version 4.6. |
| 21 | |
| 22 | ==== {{{USRMOD}}} v2 ==== |
| 23 | In order to keep the {{{USRMOD}}} approach flexibility with the new models produced by the [http://feynrules.phys.ucl.ac.be FeynRules] package, a new independent version of the {{{USRMOD}}} scripts, called {{{USRMOD}}} v2, has been released. The "philosophy" remains the same, i.e. starting from a base model, the user add/remove/modify particles, interactions and/or parameters, then run the script and finally edit the relevant coupling expressions. |
| 24 | |
| 25 | Compare to the first version, it has the following advantages: |
| 26 | * Fully compatible with (and ''only'' with) all models produced by [http://feynrules.phys.ucl.ac.be FeynRules], so the base model can be the SM but also any other model previously produced, including those produced by the {{{USRMOD}}} v2 itself! |
| 27 | * No limitation for the possible modifications. The {{{USRMOD}}} v2 propose to first save a "copy" of the base model and adjust all files to reflects the user changes. |
| 28 | * Safer thanks to additional internal consistency checks |
| 29 | * Evolutive object-oriented Python code |
| 30 | |
| 31 | Note this approach is really complementary to the full [http://feynrules.phys.ucl.ac.be FeynRules] method. For full models, including a coherent set of particles/interactions (from the QFT perspective), [http://feynrules.phys.ucl.ac.be FeynRules] should be used. For limited phenomenological studies of particular effects due to one or a few particles, with/or a restricted set of new interactions, the USRMOD= v2 is a fast and efficient alternative. |
| 32 | |
| 33 | The main README file and the beta version (now fully functional) distribution of this code is available in attachment. All questions/remarks should be sent to MichelHerquet. |
| 34 | |
| 35 | |
| 36 | -- Main.MichelHerquet - 02 Mar 2009 |
| 37 | |
| 38 | |
| 39 | |