class AtlEvent: public HepEvent

 Default constructor

 Default destructor

 Clear event

 Initialise event content

 Print event information

 Options available:
   "ALL"      - all of the above (default)
   "HDR"      - event header
   "TRIG"     - trigger
   "NOTRIG"   = Do not print trigger information, eg "ALL-NOTRIG"
   "SUM"      - energy sums
   "JET"      - jets
   "PRT"      - MC truth particles
   "TRT"      - TRT hits
   "ELEC"     - Electrons
   "MUON"     - Muons
   "TAU"      - Taus
   "PHOT"     - Photons
   "TRK"      - Tracks
   "VTX"      - Vertices
   "K0S"      - Reconstructed K0s
   "CONV"     - Reconstructed photoconversions
   "ZDEC"     - Reconstructed Z0 decays
   "WDEC"     - Reconstructed W decays
   "TOP"      - Reconstructed top-quark decays

 Add jet of given type to the list of jets

 Add MC truth particle to the list of particles

 Add MC truth vertex to the list of MC vertices

 Add inner detector track to list of ID tracks

 Add inner detector track to list of ID tracks

 Add TRT digitisation to list of TRT hits

 Add Pixel digitisation to list of Pixel hits

 Add SCT digitisation to list of SCT hits

 Add electron to the list of electrons

 Add muon to the list of muons

 Add tau to the list of taus

 Add photon to the list of photons

 Add electron to the list of electrons

 Add muon to the list of muons

 Add tau to the list of taus

 Add photon to the list of photons

 Add reconstructed Top pair to list of Top pairs

 Add reconstructed Top decay to list of Top decays

 Add reconstructed W -> l+nu decay to list of W decays

 Add neutrino to the list of reconstructed neutrinos

 Valid PDG codes:
    12 = nu_e
   -12 = nu_e_bar
    14 = nu_mu
   -14 = nu_mu_bar
    16 = nu_tau
   -16 = nu_tau_bar

 Check PDG code first

 Add reconstructed Z0 decay to list of Z0 decays

 Add reconstructed Z0 decay to list of Z0 decays

 Add reconstructed Lambda decay to list of Lambda decays

 Add reconstructed D0 decay to list of D0 decays

 Add reconstructed Dstar decay to list of Dstar decays

 Add reconstructed Phi decay to list of Phi decays

 Add reconstructed vertex to the list of vertices

 Get MC particle by its Id

 Try to avoid this function since it is rather slow.
 Also, the Id numbers might not be unique.
 Instead fetch the particle from the clones array via
 GetMCParticles()->At(i)

good=kTRUE (default): Returns all MC Tops,which decay in W and quark(but not t-quark)
good=kFALSE	  :Returns all MCTops produced by the generator
 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Look at chain of daughters of 'particle'
 and return the daughter which actually
 gives birth to another particle.
 This is written to help out in case of bad MC samples
 where mother particles give birth to themselves.

 Get Electron by its Id

 Try to avoid this function since it is rather slow.
 Also, the Id numbers might not be unique.
 Instead fetch the particle from the clone array via
 GetElectrons()->At(i)

 Get Muon by its Id

 Try to avoid this function since it is rather slow.
 Also, the Id numbers might not be unique.
 Instead fetch the particle from the clone array via
 GetElectrons()->At(i)

 Return list of all MC particles of given type

 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Print all MC particle of given type

 Get list of all MC true neutrino particles


 !! IMPORTANT: The user is responsible for deleting the !!
 !! returned TList in order to avoid memory leaks       !!

 Get MC truth neutrino with largest Pt

 Print all daughters of given MC particle

 Print all mother particles of given MC particle

 Get list of all anchestors of given MC particle


 !!! The user is responsible for deleting the returned list     !!!
 !!! (not the list elements!) afterwards to avoid memory leaks. !!!

 Print all anchestors of given MC particle

 Helper function

 Print full tree of daughters, grand-daughters, ... for given particle
 with the exception of any particles in check list
 (this is to prevent from double-printing)


 GINUS denotes (in this order):

 IsGenerator()
 IsGenInteracting()
 IsGenNonInteracting()
 IsGenSimulStable()
 IsGenStable()

 Print genealogical tree of all MC particles within
 given range of IDs

 !!! Warning: Output might be huge !!!

 Get jet of given type with largest Et

 Return no. of jets for given type

 Set no. of jets for given type

 Return all jets of given type

 Returns a list of electrons matching the given conditions.

 The author variable indicates the reconstruction type for the
 electrons. Combinations are possible. For details see the
 AtlElectron class.
 With the help of the IsEM type one can search for loose, medium
 or tight electrons.
 The list is sorted in descending order of Pt by default.
 Pt limits are given in GeV.
 The list can be composed of electrons excluding the crack region
 of the EM calorimeter (default) or including it.
 If the isolation requirement EtCone20 should be modified by a
 pt-dependence like EtCone20 + factor*Pt, then the factor can be
 given as EtCone20_IsoFactor.
 If the use of cluster eta is desired for the eta cut, then set
 use_cluster_eta to kTRUE.


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of tracks matching the given conditions.
 Pt limits are given in GeV.


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of tracks matching the given conditions.
 Pt limits are given in GeV.


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of tracks matching the given conditions.
 Pt limits are given in GeV.


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of photons matching the given conditions.

 The author variable indicates the reconstruction type for the
 photons. Combinations are possible. For details see the
 AtlPhoton class.
 With the help of the IsEM type one can search for loose, medium
 or tight photons.
 The list is sorted in descending order of Pt by default.
 Pt limits are given in GeV


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of muons matching the given conditions.

 The author variable indicates the reconstruction type for the
 muons. Combinations are possible. For details see the AtlMuon
 class.
 The Chi2_max value indicates the upper allowed limit
 for the chi2/ndof of the track-segment matching of the muons.
 Per default, muons that are combined STACO are chosen now
 (option combined_staco).
 The list is sorted in descending order of Pt by default.
 Pt limits are given in GeV


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of jets matching the given conditions.

 The list is sorted in descending order of Et by default.
 Et limits are given in GeV.
 If is_good = kTRUE, only good jets will be accepted.


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of taus matching the given conditions.

 The author variable indicates the reconstruction type for the
 taus. Combinations are possible. For details see the AtlTau
 class. With the help of the TauFlag a quality cut of the taus
 is possible.
 The list is sorted in descending order of Pt by default.
 Pt limits are given in GeV


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns list of HepMCParticle objects characterized by
 IsGenStable() = 1 , meaning that they either
 - escape the detector
   or
 - are detected.
 1st Purpose: feeding the FindMatchedParticles function
 with a more sensible list in case of MC particles.


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns list of particles with given type
 Since the MC particles generation operates at following steps,
 there are many identical particles that
 either - propagate without changing their kinematics
     or - are just deviated by under-threshold interactions
 being anyway unuseful (and misleading) in a MCTruth Plotting
 context.
 The RemoveDouble option is used to remove the same particles
 from the list


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of jets which overlap with the given
 electron by using the variable DeltaR, computed by usage
 of the cluster eta and phi of the electron (default
 value DeltaR = 0.1).
 The user must give the sample of objects (for example HepJets,
 AtlJets, ...).
 The returned list is sorted in order of increasing DeltaR.


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of jets which overlap with the given
 electron by using the variable DeltaR, optionally computed
 by usage of the ID-track eta and phi of the electron (default
 value DeltaR = 0.1) and the jet detector positions
 (eta_EMScale+EMJES_EtaCorr and phi_EMSCALE).
 The user must give the sample of objects (MUST BE AtlJet!).
 The returned list is sorted in order of increasing DeltaR.


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of jets which overlap with the given
 muon by using the variable DeltaR (default
 value DeltaR = 0.1), computed by usage of the jet
 detector positions (eta_EMScale+EMJES_EtaCorr and phi_EMSCALE).
 The user must give the sample of objects (MUST BE AtlJet!).
 The returned list is sorted in order of increasing DeltaR.


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of jets which overlap with the given
 HepParticle object by using the variable DeltaR, default
 value DeltaR = 0.1.
 The user must give the sample of objects (for example HepJets,
 AtlJets, ...).
 The returned list is sorted in order of increasing DeltaR.


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of particles which best match the given HepParticle
 object by using the variables DeltaR, default value DeltaR = 0.1.
 and DeltaPtFrac, also default of 0.1.
 The user must provide a list of objects (for example HepMCParticles,
 AtlElectrons, ...).
 For feeding it with a list of more sensible MC objects please use
 the GetStableMCParticles function at line 1397. It bypasses the
 compilation issues (impossible casting) encountered for a "Remove"
 option (e.g. in lines 1497-1499 of AtlEvent:article)


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of jets which best match the given HepJet
 object by using the variable DeltaR, default value DeltaR = 0.2.
 and DeltaPtFrac, default 0.2
 The user must give the sample of objects (for examples HepMCParticles,
 AtlElectrons, ...)
 For feeding it with a sample of more sensible MC objects please use
 the GetStableMCParticles function at line 1397. It bypasses the
 compilation issues (impossible casting) encountered for a "Remove"
 option (e.g. in lines 1497-1499 of AtlEvent::FindMatchedMCParticle)


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of truth-matched jets of the requested type.
 For each jet type the search list is simply the list of all
 jets of this type in the event.
 The value for DeltaR is set according to the (cone-)radius used
 in the jet definition of this type. There is no PtFrac requirement
 used for the truth-matching here. All MC particles are considered.
 Default is set to jet type AntiKt4H1Topo.


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of truth-matched jets of the requested type.
 A search list must be provided by the user.
 The value for DeltaR is set according to the (cone-)radius used
 in the jet definition of this type. There is no PtFrac requirement
 used for the truth-matching here. All MC particles are considered.


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of jets which best match the given HepParticle
 object by using the variable DeltaR, default value DeltaR =
 0.2. and DeltaEtFrac, also default of 0.2. The given search
 list is the list of jets to search. The option UseDeltaRonly
 (default=false) can be used to disable the DeltaPtFrac usage
 completely.


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns a list of jets which best match the given HepJet
 object by using the variable DeltaR, default value DeltaR = 0.2.
 and DeltaEtFrac, also default of 0.2.
 The user must give the sample of HepJet objects for comparison
 (HepJet or AtlJet).  It bypasses the compilation issues
 (impossible casting) encountered for a "Remove"
 option (e.g. in lines 1497-1499 of AtlEvent::FindMatchedMCParticle)


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Returns the MC particle which best matches the given HepParticle object
 by using:

 1) cone difference
    - default value DeltaR = 0.1

 2) percentual Pt difference normalized to the true particle's Pt
    - default value DeltaPtFrac = 0.1

 "RemoveUnstable" option allows the user to search a MC list where
 unstable MC particles are not taken into account (e.g. clusters,
 quarks which do not reach the detector).

 Returns the MC particle which best matches the given HepJet object
 by using:

 1) cone difference
    - default value DeltaR = 0.2

 2) percentual Pt difference normalized to the true particle's Pt
    - default value DeltaPtFrac = 0.2

 "RemoveUnstable" option allows the user to search a MC list where
 unstable MC particles are not taken into account (e.g. clusters,
 quarks which do not reach the detector).

 Returns the MC HL jet which best matches the given HepParticle
 object by assuming JetType AntiKt4H1Topo and using:

 1) cone difference
    - default value DeltaR = 0.2

 2) percentual Pt difference normalized to the true particle's Pt
    - default value DeltaEtFrac = 0.2

 Returns the MC HL jet which best matches the given HepJet object
 by assuming JetType AntiKt4H1Topo and using:

 1) cone difference
    - default value DeltaR = 0.2

 2) percentual Pt difference normalized to the true particle's Pt
    - default value DeltaEtFrac = 0.2

 Mt_W^2 = 2*Et_lepton*Et_miss*(1 - cos(DeltaPhi)) which is
 equivalent to Mt^2 = Et^2 - Pt^2 for vanishing neutrino and
 lepton masses.
 Use this function for the Jacobian-peak method

 Returns the summed 4-vector of all non-interacting
 MC particles

 Returns the eta of the summed 4-vector of all
 non-interacting MC particles

 Returns the phi of the summed 4-vector of all
 non-interacting MC particles

 takes List of vectors (TVector3)
 returns Sphericity computed w.r.t. these vectors

 Return list of vertices of given type


 !!! The user is responsible for deleting this list    !!!
 !!! (not its contents!) when it is not needed anymore !!!
 !!! to avoid memory leaks.                            !!!

 Return number of primary vertices

 Get the primary vertex of this event

 Get the IDTrack that is associated to the HepMCParticle
 by the hitbased Truthmatching (if it exists);
 otherwise return NULL

 Default Value for the Matching Probability is set to 0.0001

 Print all matches between reconstructed objects (electrons,
 muons, photons, tau) and trigger objects.
 For jets see member function PrintTriggerMatches(AtlJet::EType).


 !!! Currently only the matches for electrons, photons and !!!
 !!! muons are filled                                      !!!


 Options available:
    "ELEC" - Print electron matches
    "PHOT" - Print photon matches
    "MUON" - Print muon matches
    "TAU"  - Print tau lepton matches
    "ALL"  - Print all (default)

 Print all matches between given type of jets
 and trigger objects


 !!! Currently only the matches for electrons, photons and !!!
 !!! muons are filled                                      !!!

 Helper function for PrintTriggerMatches()

 Print triggger match for the given reconstructed object
 (electron, photn, jet, muon or tau)

 Add matched L1 item to reconstructed object

 Add matched HLT item to reconstructed object

 Compute the relative transverse momentum Pt_rel between the
 given particle and the given list of jets nearest in DeltaR.
 Only jets within the given cone of DeltaRmax are considered.
 The corresponding DeltaR between the lepton and the selected
 jet is also given.

 The return values PtRel and DeltaR are passed by reference. In
 case no jet is found inside the given search cone, -1 will be
 returned for both values.

 Generic event information

 Event reconstruction

 W boson transverse mass reconstruction for given
 lepton and missing Et

 W boson transverse mass reconstruction for given
 lepton and (commonly) reconstructed missing Et

 Getter functions

 Truth information

 Setter functions

 Set level 1 trigger item for given bit number

 Set higher level trigger item for given bit number

 Has passed given 1st level trigger ?

 Has passed given higher level trigger ?

 Test trigger matching of reconstructed object and given L1
 trigger item.

 Allowed reconstructed objects are of type AtlElectron,
 AtlPhoton, AtlMuon, AtlTau and AtlJet.

 Test trigger matching of reconstructed object and given HLT
 trigger item.

 Allowed reconstructed objects are of type AtlElectron,
 AtlPhoton, AtlMuon, AtlTau and AtlJet.

 SgTop D3PD variables