Fork me on GitHub

Changes between Version 39 and Version 40 of WorkBook/Modules


Ignore:
Timestamp:
Dec 17, 2014, 12:12:11 AM (10 years ago)
Author:
Pavel Demin
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WorkBook/Modules

    v39 v40  
     1== !AngularSmearing ==
     2
     3Performs transverse angular resolution smearing.
     4
     5 - input:
     6  - !InputArray
     7 - output:
     8  - !OutputArray
     9 - parameters:
     10  - !EtaResolutionFormula - eta resolution specified as a function of transverse momentum and pseudo-rapidity
     11  - !PhiResolutionFormula - phi resolution specified as a function of transverse momentum and pseudo-rapidity
     12
    113== BTagging ==
    214
    3 determines origin of jet, applies b-tagging efficiency (miss identification rate) formulas and sets b-tagging flags
     15Determines origin of jet, applies b-tagging efficiency (miss identification rate) formulas and sets b-tagging flags
    416
    517 - input:
     
    2840== TrackCountingBTagging ==
    2941
    30 for information on this module, see this presentation [https://cp3.irmp.ucl.ac.be/projects/delphes/raw-attachment/wiki/WorkBook/Modules/btagging_v2.pdf].
     42For information on this module, see [https://cp3.irmp.ucl.ac.be/projects/delphes/raw-attachment/wiki/WorkBook/Modules/btagging_v2.pdf this presentation].
    3143
    3244
    3345== !SimpleCalorimeter ==
    3446
    35 fills calorimeter tower, performs calorimeter resolution smearing, preselects towers hit by photons and performs an energy flow algorithm.
     47Fills calorimeter tower, performs calorimeter resolution smearing, preselects towers hit by photons and performs an energy flow algorithm.
    3648
    3749
     
    5264== Calorimeter ==
    5365
    54 fills calorimeter towers for both ECAL and HCAL, performs calorimeter resolution smearing, preselects towers hit by photons and performs an energy flow algorithm.
     66Fills calorimeter towers for both ECAL and HCAL, performs calorimeter resolution smearing, preselects towers hit by photons and performs an energy flow algorithm.
    5567ECAL and HCAL are tied together and have the same granularity. For more flexibility use !SimpleCalorimeter.
    5668
     
    7385== Efficiency ==
    7486
    75 selects candidates from the !InputArray according to the efficiency formula
     87Selects candidates from the !InputArray according to the efficiency formula
    7688
    7789 - input:
     
    8698== !EnergySmearing ==
    8799
    88 performs energy resolution smearing
     100Performs energy resolution smearing
    89101
    90102 - input:
     
    99111== !EnergyScale ==
    100112
    101 applies an energy scale to the specified object collection
     113Applies an energy scale to the specified object collection
    102114
    103115 - input:
     
    112124== !FastJetFinder ==
    113125
    114 finds jets using [http://fastjet.fr/ FastJet] library, for more information about parameters see chapters 4 and 5 of the [http://fastjet.fr/repo/fastjet-doc-3.0.2.pdf FasJet user manual]
     126Finds jets using [http://fastjet.fr/ FastJet] library, for more information about parameters see chapters 4 and 5 of the [http://fastjet.fr/repo/fastjet-doc-3.0.2.pdf FasJet user manual]
    115127
    116128 - input:
     
    197209  - IPName
    198210 
     211== !IdentificationMap ==
     212
     213This module was written specifically for LHCb, but can be used for any detector.
     214It consists in a generalized version of the Efficiency module. The user can specify not only the probably of reconstructing a particle with a given efficiency but also the probability of being misidentified as another particle. A working example is provided in the [https://github.com/delphes/delphes/blob/master/cards/delphes_card_LHCb.tcl LHCb card].
     215
     216- input:
     217  - !InputArray
     218- output:
     219  - !OutputArray
     220- parameters:
     221  - !EfficiencyFormula (usage: {PID in} {PID out} {formula})
     222
     223- Example for efficiency map:
     224
     225  - Make sure "PID in" and "PID out" have the same charge (e.g {-13} !{211} or {-321} !{211})
     226    Also, !{211} {-13} is equivalent to {-211} !{13} (and needs to be written once only...)
     227
     228  - Make sure that for a given (pt, eta) the sum of probabilities do not exceed 1.
     229
     230{{{
     231## --- pions ---
     232add EfficiencyFormula {211} {211} {(eta <= 2.0)                           * (0.00) +
     233                                   (eta > 2.0 && eta <= 5.0) * (pt < 0.8) * (0.00) +
     234                                   (eta > 2.0 && eta <= 5.0) * (pt >= 0.8)* (0.95) +
     235                                   (eta > 5.0)                            * (0.00)}
     236
     237add EfficiencyFormula {211} {-13} {(eta <= 2.0)                           * (0.00) +
     238                                   (eta > 2.0 && eta <= 5.0) * (pt < 0.8) * (0.00) +
     239                                   (eta > 2.0 && eta <= 5.0) * (pt >= 0.8)* (0.005 + 0.0663*exp(-0.13*pt*cosh(eta))) +
     240                                   (eta > 5.0)                            * (0.00)}
     241
     242## --- kaons ---
     243
     244add EfficiencyFormula {321} {321} {(eta <= 2.0)              * (0.00) +
     245                                   (eta > 2.0 && eta <= 5.0) * (pt < 0.8) * (0.00) +
     246                                   (eta > 2.0 && eta <= 5.0) * (pt >= 0.8)* (0.95) +
     247                                   (eta > 5.0)               * (0.00)}
     248
     249add EfficiencyFormula {321} {-13} {(eta <= 2.0)              * (0.00) +
     250                                   (eta > 2.0 && eta <= 5.0) * (pt < 0.8) * (0.00) +
     251                                   (eta > 2.0 && eta <= 5.0) * (pt >= 0.8)* (0.005 + 0.086*exp(-0.11*pt*cosh(eta))) +
     252                                   (eta > 5.0) * (0.00)}
     253
     254## --- protons ---
     255
     256add EfficiencyFormula {2212} {2212} {(eta <= 2.0) * (0.00) +
     257                                     (eta > 2.0 && eta <= 5.0) * (pt < 0.8) * (0.00) +
     258                                     (eta > 2.0 && eta <= 5.0) * (pt >= 0.8)* (0.95) +
     259                                     (eta > 5.0) * (0.00)}
     260
     261add EfficiencyFormula {2212} {-13} {(eta <= 2.0) * (0.00) +
     262                                    (eta > 2.0 && eta <= 5.0) * (pt < 0.8) * (0.00) +
     263                                    (eta > 2.0 && eta <= 5.0) * (pt >= 0.8)* (0.002) +
     264                                    (eta > 5.0) * (0.00)}
     265## --- muons ---
     266
     267add EfficiencyFormula {-13} {-13} {(eta <= 2.0) * (0.00) +
     268                                   (eta > 2.0 && eta <= 5.0) * (pt < 0.8)* (0.00) +
     269                                   (eta > 2.0 && eta <= 5.0) * (pt >= 0.8)* (0.97) +
     270                                   (eta > 5.0) * (0.00)}
     271
     272## efficiency for other charged particles (should be always {0} {0} {formula})
     273
     274add EfficiencyFormula {0} {0} {(eta <= 2.0) * (0.00) +
     275                               (eta > 2.0 && eta <= 5.0) * (pt < 0.8) * (0.00) +
     276                               (eta > 2.0 && eta <= 5.0) * (pt > 0.8) * (0.95) +
     277                               (eta > 5.0) * (0.00)}
     278}
     279}}}
    199280
    200281== Isolation ==
    201282
    202 sums transverse momenta of isolation objects (tracks, calorimeter towers, etc) within a DeltaRMax cone around a candidate, calculates fraction of this sum to the candidate's transverse momentum and outputs candidates that have the transverse momenta fraction less than PTRatioMax.
     283Sums transverse momenta of isolation objects (tracks, calorimeter towers, etc) within a DeltaRMax cone around a candidate, calculates fraction of this sum to the candidate's transverse momentum and outputs candidates that have the transverse momenta fraction less than PTRatioMax.
    203284
    204285 - input:
     
    220301== Merger ==
    221302
    222 merges multiple input arrays into one output array, sums transverse momenta and transverse energies of all input objects
     303Merges multiple input arrays into one output array, sums transverse momenta and transverse energies of all input objects
    223304
    224305 - input:
     
    232313== !MomentumSmearing ==
    233314
    234 performs transverse momentum resolution smearing
     315Performs transverse momentum resolution smearing
    235316
    236317 - input:
     
    245326== !ParticlePropagator ==
    246327
    247 propagates charged and neutral particles from a given vertex to a cylinder defined by its radius,
     328Propagates charged and neutral particles from a given vertex to a cylinder defined by its radius,
    248329its half-length, centered at (0,0,0) and with its axis oriented along the z-axis
    249330
     
    264345== !TauTagging ==
    265346
    266 determines origin of jet, applies tau-tagging efficiency (miss identification rate) formulas and sets tau-tagging flags
     347Determines origin of jet, applies tau-tagging efficiency (miss identification rate) formulas and sets tau-tagging flags
    267348
    268349 - input:
     
    282363== !TreeWriter ==
    283364
    284 fills ROOT tree branches
     365Fills ROOT tree branches
    285366
    286367 - parameters:
     
    289370== !UniqueObjectFinder==
    290371
    291 finds uniquely identified photons, electrons, taus and jets
     372Finds uniquely identified photons, electrons, taus and jets
    292373
    293374 - parameters: