PYTHIA8/pythia8145/phpdoc/SampleMainPrograms.php

   1 <html>
   2 <head>
   3 <title>Sample Main Programs</title>
   4 <link rel="stylesheet" type="text/css" href="pythia.css"/>
   5 <link rel="shortcut icon" href="pythia32.gif"/>
   6 </head>
   7 <body>
   8
   9 <script language=javascript type=text/javascript>
  10 function stopRKey(evt) {
  11 var evt = (evt) ? evt : ((event) ? event : null);
  12 var node = (evt.target) ? evt.target :((evt.srcElement) ? evt.srcElement : null);
  13 if ((evt.keyCode == 13) && (node.type=="text"))
  14 {return false;}
  15 }
  16
  17 document.onkeypress = stopRKey;
  18 </script>
  19 <?php
  20 if($_POST['saved'] == 1) {
  21 if($_POST['filepath'] != "files/") {
  22 echo "<font color='red'>SETTINGS SAVED TO FILE</font><br/><br/>"; }
  23 else {
  24 echo "<font color='red'>NO FILE SELECTED YET.. PLEASE DO SO </font><a href='SaveSettings.php'>HERE</a><br/><br/>"; }
  25 }
  26 ?>
  27
  28 <form method='post' action='SampleMainPrograms.php'>
  29
  30 <h2>Sample Main Programs</h2>
  31
  32 Descriptions of available classes, methods and settings are all
  33 very good and useful. Ultimately they are necessary for you to
  34 be able to fine-tune your runs to the task at hand. To get going,
  35 however, nothing helps like having explicit examples to study.
  36 This is what is provided in the <code>examples</code> subdirectory,
  37 along with instructions how they should be run:
  38 <ul>
  39
  40 <li><code>main01.cc</code> : a simple study of the charged multiplicity
  41 for jet events at the LHC. (Brief example fitting on one slide.)</li>
  42
  43 <li><code>main02.cc</code> : a simple study of the <i>pT</i> spectrum
  44 of Z bosons at the Tevatron. (Brief example fitting on one slide.)</li>
  45
  46 <li><code>main03.cc</code> : a simple single-particle analysis of jet
  47 events, where input is set by <code>main03.cmnd</code> "cards file".</li>
  48
  49 <li><code>main04.cc</code> : a simple study of several different kinds
  50 of events, with the choice to be made in the <code>main04.cmnd</code>
  51 "cards file".</li>
  52
  53 <li><code>main05.cc</code> : generation of QCD jet events at the LHC,
  54 with jet analysis using the <code>CellJet</code> cone-jet finder.</li>
  55
  56 <li><code>main06.cc</code> : tests of cross sections for elastic and
  57 diffractive topologies, using <code>main06.cmnd</code> to pick process.</li>
  58
  59 <li><code>main07.cc</code> : tests of cross sections for minimum-bias
  60 events, using <code>main07.cmnd</code> to pick options.</li>
  61
  62 <li><code>main08.cc</code> : generation of the QCD jet cross section
  63 by splitting the run into subruns, each in its own <i>pT</i> bin,
  64 and adding the results properly reweighted. Two options, with limits
  65 set either in the main program or by subrun specification in the
  66 <code>main08.cmnd</code> file.</li>
  67
  68 <li><code>main09.cc</code> : generation of LEP1 hadronic events, i.e.
  69 <i>e^+e^- -> gamma*/Z^0 -> q qbar</i>, with charged multiplicity,
  70 sphericity, thrust and jet analysis.</li>
  71
  72 <li><code>main10.cc</code> : illustration how userHooks can be used
  73 interact directly with the event-generation process.</li>
  74
  75 <li><code>main11.cc</code> : generation of two predetermined hard
  76 interactions in each event.</li>
  77
  78 <li><code>main12.cc</code> : a study of top events, fed in from the
  79 Les Houches Event File <code>ttbar.lhe</code>, here generated by
  80 PYTHIA 6.4. This file currently only contains 100 events
  81 so as not to make the distributed PYTHIA package too big, and so serves
  82 mainly as a demonstration of the principles involved. </li>
  83
  84 <li><code>main13.cc</code> : a more sophisticated variant of
  85 <code>main12.cc</code>, where two Les Houches Event Files
  86 (<code>ttbar.lhe</code> and <code>ttbar2.lhe</code>) successively
  87 are used as input. Also illustrating some other aspects, like the
  88 capability to mix in internally generated events.</li>
  89
  90 <li><code>main14.cc</code> : a systematic comparison of several
  91 cross section values with their corresponding values in PYTHIA 6.4,
  92 the latter available as a table in the code.</li>
  93
  94 <li><code>main15.cc</code> : loop over several tries, either to redo
  95 B decays only or to redo the complete hadronization chain of an event.
  96 Since much of the generation process is only made once this is a way
  97 to increase efficiency.</li>
  98
  99 <li><code>main16.cc</code> : put all user analysis code into a class
 100 of its own, separate from the main program; provide the "cards file"
 101 name as a command-line argument.</li>
 102
 103 <li><code>main17.cc</code> : collect the Pythia calls in a wrapper class,
 104 thereby simplifying the main program; provide the "cards file" name
 105 as a command-line argument.</li>
 106
 107 <li><code>main18.cc</code> : shows how to write an event filter class,
 108 where you keep a vector of pointers to the subset of particles you
 109 want to study further. The event record itself remains unchanged.</li>
 110
 111 <li><code>main19.cc</code> : use several instances of Pythia, one for
 112 signal events and others for a variable number of pileup and "beam-gas"
 113 events, combined into one common event record.</li>
 114
 115 <li><code>main20.cc</code> : shows how PYTHIA 8 can write a Les Houches
 116 Event File, using facilities potentially useful also for other programs
 117 to write an LHEF.</li>
 118
 119 <li><code>main21.cc</code> : an example how a single particle or various
 120 parton-level configurations can be input directly for hadronization,
 121 without being tied to the full process-generation machinery, e.g. to
 122 study the hadronization of junction topologies. </li>
 123
 124 <li><code>main22.cc</code> : tests of internally implemented cross sections
 125 for Supersymmetric particle production, with SYSY spectrum defined in
 126 <code>sps1a.spc</code> and settings in <code>main22.cmnd</code>. For
 127 illustration, an alternative example spectrum is also
 128 available, <code>sps1aWithDecays.spc</code>, which contains a decay
 129 table in SLHA format.</li>
 130
 131 <li><code>main23.cc</code> : shows how an external decay handler can
 132 be linked to handle the decays of some particles.</li>
 133
 134 <li><code>main24.cc</code> : shows how an external random number
 135 generator can be linked to replace the internal one.</li>
 136
 137 <li><code>main25.cc</code> : shows how an external process can be
 138 implemented as a new class derived from a PYTHIA base class, and then
 139 handed in for generation as with a normal internal process.</li>
 140
 141 <li><code>main26.cc</code> : shows how an external resonance can be
 142 implemented as a new class derived from a PYTHIA base class, and be
 143 used in an external process, both of which are then handed in for
 144 generation as with a normal internal resonance and process.</li>
 145
 146 <li><code>main27.cc</code> : shows how an external beam momentum spread
 147 and vertex location generator can be implemented as a new class derived
 148 from a PYTHIA base class, and then handed in for internal use.</li>
 149
 150 <li><code>main28.cc</code> : test program for processes in scenarios
 151 with large extra dimensions or unparticles.
 152
 153 <li><code>main29.cc</code> : set up a fictitious production process
 154 to a generic resonance, where you easily can compose your own list
 155 of (two-body) decay modes to a variety of final states. Also traces
 156 decay chains down to truly stable particles: gamma, e+-, p/pbar and
 157 neutrinos. Suitable for astroparticle applications, like neutralino
 158 pair annihilation, where cross sections are calculated separately
 159 in another program.
 160
 161 <li><code>main30.cc</code> : production of Kaluza-Klein <i>gamma/Z</i>
 162 states in TeV-sized extra dimensions.
 163
 164 <li><code>main31.cc</code> : similar to main01, except that the
 165 event record is output in the HepMC event record format. Requires
 166 that HepMC is properly linked.</li>
 167
 168 <li><code>main32.cc</code> : a streamlined version for the generation
 169 of events that are then stored in HepMC format, without any event
 170 analysis. That is, all physics studies will have to be done afterwards.
 171 The name of the input "cards file" (e.g. <code>main32.cmnd</code>)
 172 and output HepMC event file are to be provided as command-line arguments.
 173 Requires that HepMC is properly linked.</li>
 174
 175 <li><code>main41.cc</code> : a test of the shape of parton densities,
 176 as a check prior to using a given PDF set in a generator.  Requires
 177 that LHAPDF is properly linked.</li>
 178
 179 <li><code>main42.cc</code> : compares the charged multiplicity
 180 distribution, and a few other minimum-bias physics aspects, between
 181 default PYTHIA PDF and another one. Requires that LHAPDF is properly
 182 linked.</li>
 183
 184 <li><code>main43.cc</code> : tests the possibility to do backwards
 185 evolution from an incoming photon at the hard interaction. Requires
 186 that you link to a LHAPDF set that includes the photon PDF.</li>
 187
 188 <li><code>main44.cc</code> : exemplifies how you create your own
 189 PDF set and link it in for use in the process generation.</li>
 190
 191 <li><code>main51.cc</code> : exemplifies how you can link in runtime
 192 generation of hard processes from PYTHIA 6, using the Les Houches
 193 Accord facilities. This example is deprecated, since PYTHIA 8 by now
 194 contains essentially all hard processes found in PYTHIA 6.</li>
 195
 196 <li><code>main61.cc</code> : an example how the FastJet jet finding
 197 package can be linked to allow an analysis of the final state,
 198 in this case for a study of W + jet production.</li>
 199
 200 <li><code>main71.cc</code> : exemplifies an improved matching of
 201 parton showers to LHEF-style input based on the POWHEG approach,
 202 in this particular case for the POWHEG-hvq program applied to top
 203 pair production [<a href="Bibliography.php" target="page">Cor10</a>]. The small sample of input events
 204 is stored in the <code>powheg-hvq.lhe</code> file.
 205 </li>
 206
 207 <li><code>main72.cc</code> : input RPV-SUSY events from an LHEF file that
 208   contains an SLHA spectrum inside its <code><header></code>. The
 209   event file, <code>main72.lhe</code>, contains a sample events that
 210   illustrate how to arrange color tags in the presence of the
 211   color-space epsilon tensors that accompany baryon number violating
 212   event topologies.
 213 </li>
 214
 215 </ul>
 216
 217 </body>
 218 </html>
 219
 220 <!-- Copyright (C) 2010 Torbjorn Sjostrand -->