1 | | test |
| 1 | [[TOC]] |
| 2 | |
| 3 | = MG5+Delphes Tutorial - Pisa September 2018 = |
| 4 | |
| 5 | == Pre-requisites == |
| 6 | |
| 7 | To successfully run this tutorial the following prerequisite packages should be installed: |
| 8 | |
| 9 | - gcc/tcl: |
| 10 | |
| 11 | For linux users gcc/tcl should be already installed. For Mac users you should install XCode. |
| 12 | |
| 13 | - ROOT: |
| 14 | |
| 15 | can be downloaded from https://root.cern.ch/downloading-root |
| 16 | Go on latest release, and download a version under "Binary distributions". |
| 17 | |
| 18 | - Pythia8: |
| 19 | |
| 20 | following instructions from here: |
| 21 | https://cp3.irmp.ucl.ac.be/projects/delphes/wiki/WorkBook/Pythia8 |
| 22 | |
| 23 | |
| 24 | == Event generation with Pythia8 + Delphes sample == |
| 25 | |
| 26 | |
| 27 | This exercise will teach how to configure the Pythia8 event generator for a simple production of e+e- -> ZH events. Next, you will generate events and simulate the detector with the DelphesPythia8 executable. |
| 28 | |
| 29 | 0) Stare at the following example "examples/Pythia8/configNoLHE.cmnd" of Pythia8 configuration file. |
| 30 | In this card identify the parameters that control: |
| 31 | |
| 32 | - the number of events to be generated |
| 33 | - the particle beam type |
| 34 | - the center of mass energy |
| 35 | - the physics process to be generated |
| 36 | |
| 37 | 1) Create a Pythia8 configuration card that generates N=10k events of |
| 38 | ee->Zh->mumu at sqrt(s)=240 GeV. |
| 39 | |
| 40 | The identifier for the above process can be found in the Pythia8 manual: |
| 41 | |
| 42 | http://home.thep.lu.se/~torbjorn/pythia81html/Welcome.html |
| 43 | |
| 44 | Hint1: the code of electron (positron) is 11 (-11). |
| 45 | |
| 46 | Hint2: the Z decay can be forced to muons with the following syntax: |
| 47 | |
| 48 | {{{ |
| 49 | 23:onMode = off |
| 50 | 23:onIfAny = 13 -13 |
| 51 | }}} |
| 52 | |
| 53 | 2) Produce Delphes events using the above Pythia8 configuration (this command should run Pythia and Delphes on the fly!), using the CEPC detector card "cards/delphes_card_CEPC.tcl" |
| 54 | |
| 55 | Hint: find the command to be executed here (adapting it to the above Delphes and Pythia8 cards of course): |
| 56 | |
| 57 | https://cp3.irmp.ucl.ac.be/projects/delphes/wiki/WorkBook/Pythia8 |
| 58 | |
| 59 | |
| 60 | == Simple Tree analysis == |
| 61 | |
| 62 | |
| 63 | 1) Open Delphes ROOT tree and explore the branches |
| 64 | |
| 65 | {{{ |
| 66 | root -l delphes_ee_zh_zmumu.root |
| 67 | gSystem->Load("libDelphes"); |
| 68 | TBrowser t; |
| 69 | }}} |
| 70 | |
| 71 | |
| 72 | Note: Most objects are described in terms of pp specific variables (PT, Eta, Phi). |
| 73 | This is simply for historical reasons since Delphes was developed originally as a tool for LHC physics. To plot ee-like variables, one needs to write the translation (or make use of the very useful TLorentzVector of ROOT, see part III). |
| 74 | |
| 75 | 2) Interactively Draw the "leading" muon pt and energy, the muon multiplicity and the jet multiplicity. Do you understand these distributions? |
| 76 | |
| 77 | ex: |
| 78 | {{{ |
| 79 | Delphes->Draw("Muon[0].PT") |
| 80 | }}} |
| 81 | Hint: To calculate the energy approximate the muon as a massless particle and express the energy as function of pT and Eta. |
| 82 | |
| 83 | |
| 84 | == Write a simple analysis macro == |
| 85 | |
| 86 | 0) Write down the formula for the recoil Higgs mass. |
| 87 | |
| 88 | 1) You can find a simple analysis macro in "example/Example1.py". It can be executed like this: |
| 89 | |
| 90 | {{{ |
| 91 | python examples/Example1.py delphes_ee_zh_zmumu.root |
| 92 | }}} |
| 93 | |
| 94 | This Example1.py macro does not do anything interesting for this problem (it most likely produce an empty plot). You should open it with a text editor, and write a small analysis that selects two muons and reconstructs and plot the recoil Higgs mass. |
| 95 | |
| 96 | |
| 97 | == Modify the Delphes detector card == |
| 98 | |
| 99 | |
| 100 | You have now produced a Delphes simulated event with the hypothetical CEPC default detector configuration. |
| 101 | |
| 102 | 1) Can you think of two detector parameters that drive the performance of this measurement? |
| 103 | |
| 104 | 2) Identify where they are configured in the delphes detector card |
| 105 | |
| 106 | 3) Create two new detector configurations by degrade these two parameters by a sizable factor. |
| 107 | |
| 108 | 4) Reproduce a Delphes sample with these new configurations and observe the impact on the recoil mass distribution. |
| 109 | |
| 110 | |
| 111 | |