]> git.uio.no Git - u/mrichter/AliRoot.git/blobdiff - PYTHIA8/pythia8170/xmldoc/SpacelikeShowers.xml
PYTHIA8: removing legacy pythia8170
[u/mrichter/AliRoot.git] / PYTHIA8 / pythia8170 / xmldoc / SpacelikeShowers.xml
diff --git a/PYTHIA8/pythia8170/xmldoc/SpacelikeShowers.xml b/PYTHIA8/pythia8170/xmldoc/SpacelikeShowers.xml
deleted file mode 100644 (file)
index 2db8c79..0000000
+++ /dev/null
@@ -1,369 +0,0 @@
-<chapter name="Spacelike Showers">
-
-<h2>Spacelike Showers</h2>
-
-The PYTHIA algorithm for spacelike initial-state showers is 
-based on the article <ref>Sjo05</ref>, where a 
-transverse-momentum-ordered backwards evolution scheme is introduced, 
-with the extension to fully interleaved evolution covered in 
-<ref>Cor10a</ref>. 
-This algorithm is a further development of the virtuality-ordered one 
-presented in <ref>Sj085</ref>, with matching to first-order matrix 
-element for <ei>Z^0</ei>, <ei>W^+-</ei> and Higgs (in the 
-<ei>m_t -> infinity</ei> limit) production as introduced in 
-<ref>Miu99</ref>. 
-
-<p/>
-The normal user is not expected to call <code>SpaceShower</code> 
-directly, but only have it called from <code>Pythia</code>, 
-via <code>PartonLevel</code>. Some of the parameters below, 
-in particular <code>SpaceShower:alphaSvalue</code>, 
-would be of interest for a tuning exercise, however. 
-
-<h3>Main variables</h3>
-
-The maximum <ei>pT</ei> to be allowed in the shower evolution is
-related to the nature of the hard process itself. It involves a
-delicate balance between not doublecounting and not leaving any
-gaps in the coverage. The best procedure may depend on information 
-only the user has: how the events were generated and mixed (e.g. with 
-Les Houches Accord external input), and how they are intended to be 
-used. Therefore a few options are available, with a sensible default 
-behaviour.
-
-<modepick name="SpaceShower:pTmaxMatch" default="0" min="0" max="2">
-Way in which the maximum shower evolution scale is set to match the 
-scale of the hard process itself.
-<option value="0"><b>(i)</b> if the final state of the hard process 
-(not counting subsequent resonance decays) contains at least one quark 
-(<ei>u, d, s, c ,b</ei>), gluon or photon then <ei>pT_max</ei> 
-is chosen to be the factorization scale for internal processes 
-and the <code>scale</code> value for Les Houches input; 
-<b>(ii)</b> if not, emissions are allowed to go all the way up to 
-the kinematical limit. 
-The reasoning is that in the former set of processes the ISR
-emission of yet another quark, gluon or photon could lead to
-doublecounting, while no such danger exists in the latter case.
-</option>
-<option value="1">always use the factorization scale for an internal
-process and the <code>scale</code> value for Les Houches input, 
-i.e. the lower value. This should avoid doublecounting, but
-may leave out some emissions that ought to have been simulated.
-(Also known as wimpy showers.)
-</option>
-<option value="2">always allow emissions up to the kinematical limit.
-This will simulate all possible event topologies, but may lead to
-doublecounting. 
-(Also known as power showers.)
-</option>
-<note>Note 1:</note> These options only apply to the hard interaction.
-Emissions off subsequent multiparton interactions are always constrainted
-to be below the factorization scale of the process itself.  
-<note>Note 2:</note> Some processes contain matrix-element matching
-to the first emission; this is the case notably for single 
-<ei>gamma^*/Z^0, W^+-</ei> and <ei>H^0</ei> production. Then default
-and option 2 give the correct result, while option 1 should never
-be used. 
-</modepick>
-
-<parm name="SpaceShower:pTmaxFudge" default="1.0" min="0.25" max="2.0">
-In cases where the above <code>pTmaxMatch</code> rules would imply
-that <ei>pT_max = pT_factorization</ei>, <code>pTmaxFudge</code> 
-introduces a multiplicative factor <ei>f</ei> such that instead
-<ei>pT_max = f * pT_factorization</ei>. Only applies to the hardest
-interaction in an event, cf. below. It is strongly suggested that 
-<ei>f = 1</ei>, but variations around this default can be useful to 
-test this assumption. 
-</parm>
-
-<parm name="SpaceShower:pTmaxFudgeMPI" default="1.0" min="0.25" max="2.0">
-A multiplicative factor <ei>f</ei> such that 
-<ei>pT_max = f * pT_factorization</ei>, as above, but here for the
-non-hardest interactions (when multiparton interactions are allowed).
-</parm>
-
-<modepick name="SpaceShower:pTdampMatch" default="0" min="0" max="2">
-These options only take effect when a process is allowed to radiate up 
-to the kinematical limit by the above <code>pTmaxMatch</code> choice, 
-and no matrix-element corrections are available. Then, in many processes,
-the fall-off in <ei>pT</ei> will be too slow by one factor of <ei>pT^2</ei>. 
-That is, while showers have an approximate <ei>dpT^2/pT^2</ei> shape, often 
-it should become more like <ei>dpT^2/pT^4</ei> at <ei>pT</ei> values above
-the scale of the hard process. Whether this actually is the case 
-depends on the particular process studied, e.g. if <ei>t</ei>-channel 
-gluon exchange is likely to dominate. If so, the options below could
-provide a reasonable high-<ei>pT</ei> behaviour without requiring 
-higher-order calculations. 
-<option value="0">emissions go up to the kinematical limit, 
-with no special dampening.
-</option>
-<option value="1">emissions go up to the kinematical limit,  
-but dampened by a factor <ei>k^2 Q^2_fac/(pT^2 + k^2 Q^2_fac)</ei>, 
-where <ei>Q_fac</ei> is the factorization scale and <ei>k</ei> is a 
-multiplicative fudge factor stored in <code>pTdampFudge</code> below.
-</option>
-<option value="2">emissions go up to the kinematical limit, 
-but dampened by a factor <ei>k^2 Q^2_ren/(pT^2 + k^2 Q^2_ren)</ei>, 
-where <ei>Q_ren</ei> is the renormalization scale and <ei>k</ei> is a 
-multiplicative fudge factor stored in <code>pTdampFudge</code> below. 
-</option>
-<note>Note:</note> These options only apply to the hard interaction.
-Emissions off subsequent multiparton interactions are always constrainted
-to be below the factorization scale of the process itself.  
-</modepick>
-
-<parm name="SpaceShower:pTdampFudge" default="1.0" min="0.25" max="4.0">
-In cases 1 and 2 above, where a dampening is imposed at around the
-factorization or renormalization scale, respectively, this allows the
-<ei>pT</ei> scale of dampening of radiation by a half to be shifted 
-by this factor relative to the default <ei>Q_fac</ei> or <ei>Q_ren</ei>. 
-This number ought to be in the neighbourhood of unity, but variations 
-away from this value could do better in some processes.
-</parm>
-
-<p/>
-The amount of QCD radiation in the shower is determined by 
-<parm name="SpaceShower:alphaSvalue" default="0.137" min="0.06" max="0.25">
-The <ei>alpha_strong</ei> value at scale <code>M_Z^2</code>. 
-Default value is picked equal to the one used in CTEQ 5L.  
-</parm>
-
-<p/>
-The actual value is then regulated by the running to the scale 
-<ei>pT^2</ei>, at which it is evaluated
-<modepick name="SpaceShower:alphaSorder" default="1" min="0" max="2">
-Order at which <ei>alpha_strong</ei> runs,
-<option value="0">zeroth order, i.e. <ei>alpha_strong</ei> is kept 
-fixed.</option>
-<option value="1">first order, which is the normal value.</option>
-<option value="2">second order. Since other parts of the code do 
-not go to second order there is no strong reason to use this option, 
-but there is also nothing wrong with it.</option>
-</modepick>
-
-<p/>
-QED radiation is regulated by the <ei>alpha_electromagnetic</ei>
-value at the <ei>pT^2</ei> scale of a branching.
-<modepick name="SpaceShower:alphaEMorder" default="1" min="-1" max="1">
-The running of <ei>alpha_em</ei>.
-<option value="1">first-order running, constrained to agree with
-<code>StandardModel:alphaEMmZ</code> at the <ei>Z^0</ei> mass.
-</option>
-<option value="0">zeroth order, i.e. <ei>alpha_em</ei> is kept 
-fixed at its value at vanishing momentum transfer.</option>
-<option value="-1">zeroth order, i.e. <ei>alpha_em</ei> is kept 
-fixed, but at <code>StandardModel:alphaEMmZ</code>, i.e. its value
-at the <ei>Z^0</ei> mass.
-</option> 
-</modepick>
-
-<p/>
-The natural scale for couplings and PDFs is <ei>pT^2</ei>. To explore 
-uncertainties it is possibly to vary around this value, however, in 
-analogy with what can be done for 
-<aloc href="CouplingsAndScales">hard processes</aloc>.
-
-<parm name="SpaceShower:renormMultFac" default="1." min="0.1" max="10.">
-The default <ei>pT^2</ei> renormalization scale is multiplied by 
-this prefactor. For QCD this is equivalent to a change of 
-<ei>Lambda^2</ei> in the opposite direction, i.e. to a change of 
-<ei>alpha_strong(M_Z^2)</ei> (except that flavour thresholds 
-remain at fixed scales). Below, when <ei>pT^2 + pT_0^2</ei> is used
-as scale, it is this whole expression that is multiplied by the prefactor.
-</parm>
-
-<parm name="SpaceShower:factorMultFac" default="1." min="0.1" max="10.">
-The default <ei>pT^2</ei> factorization scale is multiplied by 
-this prefactor. 
-</parm>
-
-<p/>
-There are two complementary ways of regularizing the small-<ei>pT</ei> 
-divergence, a sharp cutoff and a smooth dampening. These can be 
-combined as desired but it makes sense to coordinate with how the 
-same issue is handled in multiparton interactions.
-
-<flag name="SpaceShower:samePTasMPI" default="off">
-Regularize the <ei>pT -> 0</ei> divergence using the same sharp cutoff 
-and smooth dampening parameters as used to describe multiparton interactions.
-That is, the <code>MultipartonInteractions:pT0Ref</code>, 
-<code>MultipartonInteractions:ecmRef</code>, 
-<code>MultipartonInteractions:ecmPow</code> and 
-<code>MultipartonInteractions:pTmin</code> parameters are used to regularize 
-all ISR QCD radiation, rather than the corresponding parameters below. 
-This is a sensible physics ansatz, based on the assumption that colour 
-screening effects influence both MPI and ISR in the same way. Photon 
-radiation is regularized separately in either case.
-<note>Warning:</note> if a large <code>pT0</code> is picked for multiparton 
-interactions, such that the integrated interaction cross section is 
-below the nondiffractive inelastic one, this <code>pT0</code> will 
-automatically be scaled down to cope. Information on such a rescaling 
-does NOT propagate to <code>SpaceShower</code>, however.
-</flag> 
-
-<p/>
-The actual <code>pT0</code> parameter used at a given CM energy scale, 
-<ei>ecmNow</ei>, is obtained as
-<eq>
-    pT0 = pT0(ecmNow) = pT0Ref * (ecmNow / ecmRef)^ecmPow 
-</eq>
-where <ei>pT0Ref</ei>, <ei>ecmRef</ei> and <ei>ecmPow</ei> are the 
-three parameters below.
-
-<parm name="SpaceShower:pT0Ref" default="2.0" 
-min="0.5" max="10.0">
-Regularization of the divergence of the QCD emission probability for 
-<ei>pT -> 0</ei> is obtained by a factor <ei>pT^2 / (pT0^2 + pT^2)</ei>, 
-and by using an <ei>alpha_s(pT0^2 + pT^2)</ei>. An energy dependence 
-of the <ei>pT0</ei> choice is introduced by the next two parameters, 
-so that <ei>pT0Ref</ei> is the <ei>pT0</ei> value for the reference 
-cm energy, <ei>pT0Ref = pT0(ecmRef)</ei>.   
-</parm>
-
-<parm name="SpaceShower:ecmRef" default="1800.0" min="1.">
-The <ei>ecmRef</ei> reference energy scale introduced above.
-</parm>
-
-<parm name="SpaceShower:ecmPow" default="0.0" min="0." max="0.5">
-The <ei>ecmPow</ei> energy rescaling pace introduced above.
-</parm>
-
-<parm name="SpaceShower:pTmin" default="0.2" 
-min="0.1" max="10.0">
-Lower cutoff in <ei>pT</ei>, below which no further ISR branchings 
-are allowed. Normally the <ei>pT0</ei> above would be used to 
-provide the main regularization of the branching rate for 
-<ei>pT -> 0</ei>, in which case <ei>pTmin</ei> is used  mainly for 
-technical reasons. It is possible, however, to set <ei>pT0Ref = 0</ei> 
-and use <ei>pTmin</ei> to provide a step-function regularization, 
-or to combine them in intermediate approaches. Currently <ei>pTmin</ei> 
-is taken to be energy-independent.  
-</parm>
-
-<parm name="SpaceShower:pTminChgQ" default="0.5" min="0.01">
-Parton shower cut-off <ei>pT</ei> for photon coupling to a coloured 
-particle.
-</parm>
-
-<parm name="SpaceShower:pTminChgL" default="0.0005" min="0.0001">
-Parton shower cut-off mass for pure QED branchings. 
-Assumed smaller than (or equal to) <ei>pTminChgQ</ei>.
-</parm>
-
-<flag name="SpaceShower:rapidityOrder" default="off">
-Force emissions, after the first,  to be ordered in rapidity,
-i.e. in terms of decreasing angles in a backwards-evolution sense. 
-Could be used to probe sensitivity to unordered emissions.
-Only affects QCD emissions.
-</flag>
-
-<h3>Further variables</h3>
-
-These should normally not be touched. Their only function is for
-cross-checks.
-
-<p/>
-There are three flags you can use to switch on or off selected
-branchings in the shower: 
-
-<flag name="SpaceShower:QCDshower" default="on">
-Allow a QCD shower; on/off = true/false.
-</flag>
-
-<flag name="SpaceShower:QEDshowerByQ" default="on">
-Allow quarks to radiate photons; on/off = true/false.
-</flag>
-
-<flag name="SpaceShower:QEDshowerByL" default="on">
-Allow leptons to radiate photons; on/off = true/false.
-</flag>
-
-<p/>
-There are some further possibilities to modify the shower:
-
-<flag name="SpaceShower:MEcorrections" default="on">
-Use of matrix element corrections; on/off = true/false.
-</flag>
-
-<flag name="SpaceShower:MEafterFirst" default="on">
-Use of matrix element corrections also after the first emission,
-for dipole ends of the same system that did not yet radiate.
-Only has a meaning if <code>MEcorrections</code> above is 
-switched on. 
-</flag>
-
-<flag name="SpaceShower:phiPolAsym" default="on">
-Azimuthal asymmetry induced by gluon polarization; on/off = true/false.
-</flag>
-
-<flag name="SpaceShower:phiIntAsym" default="on">
-Azimuthal asymmetry induced by interference; on/off = true/false.
-</flag>
-
-<parm name="SpaceShower:strengthIntAsym" default="0.7"
-min="0." max="0.9">
-Size of asymmetry induced by interference. Natural value of order 0.5; 
-expression would blow up for a value of 1.
-</flag>
-
-<modeopen name="SpaceShower:nQuarkIn" default="5" min="0" max="5">
-Number of allowed quark flavours in <ei>g -> q qbar</ei> branchings,
-when kinematically allowed, and thereby also in incoming beams. 
-Changing it to 4 would forbid <ei>g -> b bbar</ei>, etc.
-</modeopen>
-
-<h3>Technical notes</h3>
-
-Almost everything is equivalent to the algorithm in [1]. Minor changes 
-are as follows.
-<ul>
-<li>
-It is now possible to have a second-order running <ei>alpha_s</ei>,
-in addition to fixed or first-order running. 
-</li>
-<li>
-The description of heavy flavour production in the threshold region 
-has been modified, so as to be more forgiving about mismatches 
-between the <ei>c/b</ei>  masses used in Pythia relative to those 
-used in a respective PDF parametrization. The basic idea is that, 
-in the threshold region of a heavy quark <ei>Q</ei>, <ei>Q = c/b</ei>, 
-the effect of subsequent <ei>Q -> Q g</ei> branchings is negligible. 
-If so, then
-<eq>
-   f_Q(x, pT2) = integral_mQ2^pT2  dpT'2/pT'2 * alpha_s(pT'2)/2pi
-      * integral P(z) g(x', pT'2) delta(x - z x')
-</eq>
-so use this to select the <ei>pT2</ei> of the <ei>g -> Q Qbar</ei> 
-branching. In the old formalism the same kind of behaviour should 
-be obtained, but by a cancellation of a <ei>1/f_Q</ei> that diverges 
-at the theshold and a Sudakov that vanishes.
-<br/>
-The strategy therefore is that, once <ei>pT2 &lt; f * mQ2</ei>, with 
-<ei>f</ei> a parameter of the order of 2, a <ei>pT2</ei> is chosen 
-like <ei>dpT2/pT2</ei> between <ei>mQ2</ei> and <ei>f * mQ2</ei>, a
-nd a <ei>z</ei> flat in the allowed range. Thereafter acceptance
-is based on the product of three factors, representing the running
-of <ei>alpha_strong</ei>, the splitting kernel (including the mass term) 
-and the gluon density weight. At failure, a new <ei>pT2</ei> is chosen 
-in the same  range, i.e. is not required to be lower since no Sudakov 
-is involved. 
-</li>
-<li>
-The QED algorithm now allows for hadron beams with non-zero photon
-content. The backwards-evolution of a photon in a hadron is identical
-to that of a gluon, with <ei>CF -> eq^2</ei> and <ei>CA -> 0</ei>.
-Note that this will only work in conjunction with 
-parton distribution that explicitly include photons as part of the
-hadron structure (such as the MRST2004qed set). Since Pythia's
-internal sets do not allow for photon content in hadrons, it is thus 
-necessary to use the LHAPDF interface to make use of this feature. The
-possibility of a fermion backwards-evolving to a photon has not yet
-been included, nor has photon backwards-evolution in lepton beams. 
-</li>
-</ul>
-
-</chapter>
-
-<!-- Copyright (C) 2012 Torbjorn Sjostrand -->
-