PYTHIA8/pythia8145/htmldoc/ErrorChecks.html

   1 <html>
   2 <head>
   3 <title>Error Checks</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 <h2>Error Checks</h2>
  10
  11 There is a few settings related to error checking during program
  12 execution. Many other checks are performed as well, but do not
  13 have any specific setting related to themselves.
  14
  15 <p/><code>flag&nbsp; </code><strong> Check:particleData &nbsp;</strong>
  16  (<code>default = <strong>off</strong></code>)<br/>
  17 Check the particle data tables for potential problems during
  18 initialization. This includes inconsistent use of charge in particle
  19 names, inconsistent setup of mass, mass range, width and lifetime,
  20 sum of branching ratios not unity (allowed but discouraged) or charge
  21 not conserved in a decay channel. Warnings should be viewed as reasons
  22 to check further, but need not indicate a true problem, and also not all
  23 problems may be caught.
  24 The <code>pythia.particleData.checkTable(level)</code> method,
  25 used for these checks, may also be called directly.
  26
  27
  28 <p/><code>mode&nbsp; </code><strong> Check:levelParticleData &nbsp;</strong>
  29  (<code>default = <strong>1</strong></code>)<br/>
  30 The level of verbosity and checks of particle data, if switched on.
  31 <br/><code>option </code><strong> 0</strong> : mimimal amount of checks, e.g. that no channels open.
  32
  33 <br/><code>option </code><strong> 1</strong> : further warning if individual channels closed,
  34 except for resonances.
  35 <br/><code>option </code><strong> 2</strong> : also print branching-ratio-averaged threshold mass
  36 except for resonances.
  37 <br/><code>option </code><strong> 11</strong> : as 1, but include resonances in detailed checks.
  38
  39 <br/><code>option </code><strong> 12</strong> : as 2, but include resonances in detailed checks.
  40
  41
  42
  43 <p/><code>flag&nbsp; </code><strong> Check:event &nbsp;</strong>
  44  (<code>default = <strong>on</strong></code>)<br/>
  45 When an event has been successfully generated, check that the
  46 final event record in <code>event</code> does not contain any
  47 unphysical particles, or nonconserved charge or energy-momentum.
  48 If this check fails, then <code>pythia.next()</code> obtains the
  49 value <code>false</code>, i.e. the event is counted as aborted.
  50
  51
  52 <p/><code>mode&nbsp; </code><strong> Check:nErrList &nbsp;</strong>
  53  (<code>default = <strong>0</strong></code>)<br/>
  54 The number of erroneous events, in the above check, for which
  55 event listing and other detailed information will be printed.
  56 After that, only the normal error messages will be issued.
  57 Error counters are always updated, and accumulated numbers can be
  58 shown with <code>pythia.statistics()</code> at the end of the run.
  59
  60
  61 <p/><code>parm&nbsp; </code><strong> Check:epTolErr &nbsp;</strong>
  62  (<code>default = <strong>1e-4</strong></code>)<br/>
  63 Maximum allowed summed deviation of <i>E</i>, <i>p_x</i>,
  64 <i>p_y</i> and <i>p_z</i> between the incoming beams and the
  65 final state, as a fraction of the initial energy, above which the
  66 event is counted as aborted.
  67 (Unfortunetely roundoff errors do not scale linearly with the energy,
  68 and also have a very long tail. So while most events at lower energies
  69 may be correct to better than 1e-10, at LHC it does not have to signal
  70 any fundamental bug if also the default tolerance above is violated
  71 occasionally.)
  72
  73
  74 <p/><code>parm&nbsp; </code><strong> Check:epTolWarn &nbsp;</strong>
  75  (<code>default = <strong>1e-6</strong></code>)<br/>
  76 A check on the same summed deviation as above, but counted as a
  77 warning rather than an error, and not leading to the event being
  78 classified as aborted.
  79
  80
  81 </body>
  82 </html>
  83
  84 <!-- Copyright (C) 2010 Torbjorn Sjostrand -->